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PREFACE 


This book describes the logic of 
Product Supervisor Call (MVS/370 
checkpoint, and restart a job at 
that restart a job at a step are 
Logic Library , Volumes 1 through 


the MVS/370 Data Facility 
DFP SVC) routines that take a 
a checkpoint. The routines 
documented in QS/VS2 System 
7, SY28-0713 through SY28-0719. 


This book is intended for use by programming systems 
representatives and system programmers maintaining 
checkpoint/restart routines. 


ORGANIZATION 


This publication contains the following major sections* 

• "Introduction” describes the checkpoint/restart routines in 
general terms and briefly tells what they do. 

• "Method of Operation” describes the operations performed by 
checkpoint/restart routines and the input to and output from 
those operations. 

• "Program Organization” gives the flow of control between the 
modules of checkpoint/restart and describes the major 
operations performed by each module. 

• "Module Directory” lists each checkpoint/restart module and 
refers to a diagram in "Program Organization" or "Method of 
Operation" that describes each module. 

• "Data Areas" shows the data areas used by checkpoint/restart 
routines. 

• "Diagnostic Aids" lists the messages, message codes, and 
return codes generated by checkpoint/restart modules. 

• "Abbreviations" lists the acronyms and abbreviations used in 
this book and their meanings. 


PREREQUISITE KNOWLEDGE 

A general understanding of how a user requests that a checkpoint 
be taken and restarts a job is prerequisite knowledge for 
understanding the information in this book. For this type of 
information, see MVS/370 Checkpoint/Restart , GC26-4054. 

Additional prerequisite knowledge is contained in MVS/370 VSAM 
Logic . LY26-3928. 
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RELATED PUBLICATIONS 


Within the text, references are made to the publications listed 
in the table below. 


Short Title 

Publication Title 

Order 

Number 

ACF/TCAM Logic 

Advanced Communication 
Function for TCAM Lociic 

LY30-3036 

Data Areas 

MVS/370 Data Facility 

Product Data Areas 

LJB6-0096 

Data Areas - 
0S/VS2 

QS/VS2 Data Areas 

SYB8-0606 

Symbol Cross 
Reference 

MVS/370 Data Facility 

Product Symbol Cross 

Reference Listinas 

LJB6-0095 

TCAM Logic 

TCAM Loaic 

SY30-2059 

VIO Logic 

MVS/370 VIO Loaic 

LY26-3927 
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SUMMARY OF AMENDMENTS 


I RELEASE 1.1 LXBRARY UPDATE, PECEMBER 19S5 
| SERVICE CHANGES 


All MVS/370 titles referred to in this publication have been 
changed to their corresponding MVS/XA titles. 

Information has been added to reflect technical service changes. 
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INTRODUCTION 


Checkpoint/restart Is a technique for recording information 
about a job at programmer-designated checkpoints so that the job 
can be restarted at one of these checkpoints or at the beginning 
of a job step. This book documents the logic of those routines. 
Restart of a job at a step is performed by scheduler termination 
routines* which are documented in System Logic library . 

When the system is loaded* checkpoint/restart modules are taken 
from SYS1.1PALIB and loaded into the link pack area. These 
modules are paged into real storage for execution as they are 
needed. 


OVERVIEW OF CHECKPOINT PROCESSING 

The user takes a checkpoint by coding the CHKPT macro in the 
program. C Checkpoint/Restart shows how to code the CHKPT 
macro.) Execution of the CHKPT macro causes the checkpoint 
routines to save the contents of the user’s region and all the 
information necessary to restart the user's program. This 
information is saved in a data set (called the checkpoint data 
set) that resides on one or more tape or direct access volumes. 
The user must provide a DD statement and a DCB macro for the 
checkpoint data set. 


OVERVIEW OF RESTART PROCESSING 

The user can request that a job be restarted without being 
resubmitted (called automatic restart)* or the user can resubmit 
the job for restart (called deferred restart). Automatic 
restarts must be authorized by the operator; deferred restarts 
take place without operator authorization when a job is 
resubmitted. 

Automatic and deferred restart can take place from a checkpoint 
or from the beginning of a job step. They are requested in the 
following manner* 

Type of Restart 

Automatic checkpoint 
restart 

Automatic step restart 


Deferred checkpoint 
restart 


Deferred step restart 


How Requested 

CHKPT macro (RD=NC or RNC must not be 
specified in the RD parameter) 

RD parameter in the JOB or EXEC statement 
(RD=R or RHC must be specified) 

RESTART parameter in the JOB statement 
and a SYSCHK DD statement in the 
resubmitted deck 

RESTART parameter in the JOB statement in 
the resubmitted deck 


( Checkpoint/Restart shows how to code these parameters and 
statements.) 

Restart routines re-create the environment that existed when a 
checkpoint was taken. They open the checkpoint data set and* 
using the information that was saved in it when the checkpoint 
was taken* restore the user's region and task control 
information. They then position any user data sets open when 
the checkpoint was taken. 
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METHOD OF OPERATION 


This section consists of method of operation diagrams. These 
diagrams describe the major operations performed by checkpoint 
and restart modules and the data that is input to, and output 
from, those operations. 

The operations described in each diagram are further amplified 
in the adjoining "Notes to Diagram....” These notes tie the 
operations to a specific module and, where possible, to a label 
in that module. 

Diagram lisa table of contents for the method of operation 
diagrams. It shows, at the highest level, each operation 
performed by checkpoint/restart and directs you to the specific 
diagram documenting the operation. Diagrams 2 and 8 show the 
major operations performed by checkpoint (Diagram 2) and restart 
(Diagram 8), respectively, and the data that is input to, and 
output from, those operations. Following is an explanation of 
the graphic symbols used in the method of operation diagrams. 


Control flow 


Data flow 


Entry point to diagram. The 
second type of arrow is used 
when a diagram has more 
than one entry point. 




Input to or output from a 
processing step 


► 


Flow of control 




Modification of data 



On-page connector; number 
represents number of 
processing step receiving 
control 


Testing of, or reference to, data 



Off-page connector; number 
is number of diagram where 
processing resumes 


©=> 


On*page connector; used to 
indicate input to or output 
from a processing step 
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Restart 
overview 
(Diagram 8) 
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Notes to Diagram 3 

IHJACPOO (IGC0006C) 

1 Determines whether the user 
requested that checkpoints be 
suppressed (RD=NC or RNC coded on 
user’s JOB or EXEC statement). If 
so , returns to user. 

2 Clears the SVRB extended save area* 
which is subsequently used as a 
message parameter list in checkpoint 
exit processing. 

Determines whether the user 
requested cancellation of automatic 
restart. (This request made via 
CANCEL parameter in CHKPT macro.) 

If so, sets a flag (HKPFLAG) to 
indicate cancellation. Then obtains 
a 640-byte checkpoint work area and 
continues processing at step 6c. 

3 Issues the SETLOCK macro to get the 
local lock and then checks whether 
the parameters specified in the 
CHKPT macro are valid. If not, 
releases the local lock and 
continues processing at step 9. 

4 Releases the local lock. Determines 
whether the current task is a 
subtask or has subtasks. If so, 
continues processing at step 9. 

5 Determines whether the user has 
already opened the checkpoint data 
set. If not, opens it. If the 
checkpoint data set is not 
successfully opened, continues 
processing at step 9. 


a) Using the following formula, 
determines the number of bytes 
needed to build the checkpoint 
work area* 

work area = TIOT length + 1220 
+ 4096 + 48(no. DEBs - 2) 

b) Issues a conditional GETMAIN 
macro to obtain space for the 
checkpoint work area. If not 
enough storage is available, 
continues processing at step 9. 

c) Clears the first 256 bytes of 
the work area and initializes 
various fields in it. 

7 If the user canceled automatic 
restart, continues processing at 
step 9. 

8 The following security tests are 
made: 


a) If the checkpoint data set is 
known to be secure (DSABCKDS and 
DSABCKVL bits are on) but one of 
the following conditions exists, 
clears the checkpoint data set 
bit in the data set label 
(indicating that the data set 
has failed the security test). 
Then continues processing at 
step 9. 

• The checkpoint data set is 
on a shared device. 

• Another DCB is open to a 
data set with the same DSN 
as the checkpoint data set. 

• The checkpoint data set is 
not under exclusive control 
(DISP=SHR coded on the DD 
card). 

b) If the checkpoint data set is 
not known to be secure (DSABCKDS 
and DSABCKVL bits are off), does 
the following: 

• If the device the checkpoint 
data set is on is neither 
tape nor direct access, or 
the device is tape but the 
block count for the tape is 
not zero, continues 
processing at step 9 

• Creates a label for the data 
set, indicating it is a 
checkpoint data set. The 
Open and Close routines of 
0/C/E0V are entered during 
this process. If the Open 
routine concludes that the 
checkpoint data set is not a 
secure one, continues 
processing at step 9. 

c) If a direct access checkpoint 
data set is not empty or is not 
a BPAM or BSAM data set, clears 
the checkpoint data set bit in 
the data set label (indicating 
that the data set has failed the 
security test). Then continues 
processing at step 9. 

d) If the Open routine of O/C/EOV 
established a security interface 
(the user of the checkpoint data 
set was unauthorized so a 
security interface was 
established to prevent reading 
from or writing to the 
checkpoint data set), gets the 
address of the DCB for the 
checkpoint data set, and stores 
it in the checkpoint work area. 

9 If any of the errors listed in 
"Diagnostic Aids" were detected, 
sets a message code and gives 
control to IGC0Q06C. 
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ZHJACP01 (XGC0106C) 

If any of the errors listed in 
"Diagnostic Aids" Mere detected, 
sets a message code and gives 
control to IGC0Q06C. 

If any resources (requests made via 
ENQ macro) haven T t been released, 
sets X'0100' in the CKMSGCOD field 
in the checkpoint Mork area to 
indicate a warning message should be 
printed in IGCQQ06C. 

XHJACP02 (XGC0206C) 

10 Prepares to read the job control 
table (JCT) by getting space for a 
QMNGRIO parameter list and work 
area. Sets user authorization 
(whether authorized to issue MODESET 
macro) in CHR. 

Sets up the QMNGRIO parameter list 
with TTR of JCT (gotten from JSCB). 
Reads the JCT (using QMNGRIO macro) 
into the checkpoint work area. 


Restricted Materials of IBM 
Licensed Materials - Property of XBM 

If an I/O error was detected when 
the JCT was read, sets message code 
025 in CKMSGCD2 and gives control to 
IGC0Q06C. 

11 If the user canceled automatic 
restart (this request made via 
CANCEL parameter in CHKPT macro), 
gives control to IGC0Q06C. 

12 Updates the JCTNRCKP field in the 
JCT, which indicates the number of 
checkpoints taken. 

If the user didn't supply a checkid, 
generates one. 

Moves the checkid into the 
checkpoint header record (CHR) build 
area and builds remainder of CHR. 

13 If any VSAM data sets are open, 
loads and branches to the VSAM 
checkpoint routine, IDA0C06C. (See 
VSAM Logic .) If the CKRETCOD 
routine indicates an error, gives 
control to IGC0Q06C. Otherwise, 
gives control to IGC0506C. 
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Register 1 

Checkpoint 
work area 


CKTCBAD 


From Diag 3 . 


TCBDEB 
- TCBTIO 
DEB chain 


DEBDEBAD 

DEBNMSUB 

DEBUSRPG 

DEBDCBAD 


TJOEFSRT 


The following operations are performed for each data 
set open when user issues CHKPT macro: 

1 Has last DEB in chain been processed? Yes 


-2 Should this data set be processed? 

i/! 


I * -3 Access method basic or not supported by 

I j I checkpoint/restart, or did user write own 

-7 I channel program? 


CVTTCBPT 


DCBDSQRG 
^ DCBIOBA 
DCBMACRF 
DCB1FLGS 
DCBEXCD1 
DCBEROPT 
10B chain 


^- L) 4 If access method queued, tests for error conditions: 

I j I Acceptable error or EOF on input. 


Unacceptable error. 



5 Purges user’s I/O requests. 

Purge successful? No I 

Was purge performed? Yes (^b 


^ 7 


O* 


6 Stops activity in user’s address space. 

7 Errors detected? 

No 


To part 3 


processing 


Checkpoint 

work area 

k,- 

> CKFLAG2 
\ CKRETCOD 
t> CKMSGCOD 


To part 1 to 
• build checkpoint 
data set 


jDiaX To part 3 
l 5/ error processing 
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Notes to Diagram 4 

IGC050SC 

1 Tests whether the DEB just processed 
is th6 last DEB in the chain 
(DEBDEBAD contains 0). If so* 
continues processing at step 6. 

2 Examines the DEB and its associated 
DSAB and TIOT DD entry to determine 
whether the DEB is for any of the 
following types of data sets : TCAM* 
VSAM* subsystem* dummy* ISAM (using 
the compatibility interface). If 
so* skips processing of this data 
set* gets the address of the next 
DEB in the chain* and continues 
processing at step 1. 

3 Checks DCBDSORG field to determine 
whether the access method being used 
is supported by checkpoint/restart. 
If not supported* continues 
processing at step 5. 

Checks DCBMACRF field to determine 
whether the user wrote own channel 
program or is using the basic access 
method. If so* continues processing 
at step 5. 

4 For queued access methods* checks 
DCBIFLGS and DCBEXCD1 for errors. 

If errors are posted* determines 
(from DCBEROPT field) if the errors 
are acceptable. 

If the errors are acceptable* skips 
processing of this data set* gets 
the address of the next DEB* and 
continues processing at step 1. 

If the errors are not acceptable* 
tests the IOB for EOF on input. If 
EOF was reached* skips processing of 
this data set and continues 
processing at step 1. 

If EOF was not reached* sets the 
appropriate codes in checkpoint’s 
work area and gives control to 
IGC0N06C. 

5 Sets up a purge parameter list 
containing the addresses of the DEB 
and the DEBUSRPG field. Sets the 


option field in the parameter list 
to quiesce active I/O and post the 
results of the purge operation. 

Issues the PURGE macro (SVC 16). 
Checks register 15 and the PPLCC 
field in the parameter list to 
determine whether the purge was 
successful. If not* sets the 
appropriate codes in checkpoint’s 
work area and gives control to 
IGC0NG6C. 

Checks the DEBUSRPG field to 
determine whether the purge took 
place. If so* sets the result I/O 
flag. 

If the access method was basic* gets 
the address of the next DEB and 
continues processing at step 1. If 
the access method was queued* 
rechecks for errors (as in step 4). 
If processing can continue* gets the 
address of the next DEB and 
continues processing at step 1. 

6 Issues the STATUS macro to stop 
dispatching of routines for which an 
5RB exists. Gets the dispatcher 
lock. 

Searches the SRB chains for SRBs 
associated with the user’s address 
space. If any are found* releases 
the dispatcher lock and issues the 
STATUS macro to start dispatching of 
routines associated with these SRBs. 
Continues processing at the 
beginning of this step to repeat 
this process. (Additional SRBs may 
have been added to the SRB chain 
after the dispatcher lock was 
released.) When all global SRBs 
associated with the user’s address 
space have been processed* releases 
the dispatcher lock. 

Then* after all SRBs have been 
processed* issues the STATUS macro 
so the routines associated with any 
future SRBs for the user’s address 
space can be dispatched. 

7 If no errors were detected* exits to 
IHJACP2Q (IGC0A06C). Else* exits to 
IGC0N06C. 
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Checkpoint 
work area 


j Register 1 
TCB 


j 


TCBDEB 


CKTCBAD 


CKFLAGI 


DDNT 


JFCB 


JFCB 

extensions 


GDG 


CHR 


From Dia. 4 

1 Writes CHR. C 

(££> " 2 If checkpoint data set using BPAM, gets TTR 


Checkpoint data set 


for CHR. 

3 If DDNT records exist, reads them. (JL 

^ 1^ If DDNTcandidates exist, generates new DDNTentries 

@ZjC> Writes DDNT. c 


(°K> 

©o 

&> 


SWA 


4 Reads JFCB associated with each DSAB. 0' 

If checkpoint data set is on tape, resets volume I 
| sequence numbers. 

©=p‘ Writes type I DSDR. d I ~ 1=1 

~^> 7 If JFCB extensions exist, reads them 
Writes type 2 DSDR.i 

®=p 


Checkpoint work area 


8 Last DSAB? No &+ 

O 9 If GDG name tables exist for data set, reads them. 


DEB chain 


-o- 


^ DEBDEBAD 


DEBVLSQ 







U1 


o 

-n 

M 


Dia\ To part 2 to continue building 
5 / checkpoint data set 

jDia/V To write checkpoint entry on 
j 3 S one volume 

To part 3 to continue 
building checkpoint data set 
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Notes to Diagram 5 (Part 1 of 3) 

IHJACP20 (IGC0A06C) 

1 If the checkpoint data set is on 
tape, saves the volume sequence 
number (VOLSEQNO in DEB) in the 
checkpoint work area. If the 
checkpoint data set is on a direct 
access device, saves the number of 
extents (DEBNMEXT in DEB) in the 
checkpoint work area. This 
information is used later to test 
for EOV. 

Initializes the DECB (used in 
writing the CHR). 

Writes the CHR. 

2 If the checkpoint data set is using 
BPAM, issues the NOTE macro to get 
the CHR 1 s TTR. 

IHJACP25 (IGC0D06C) 

3 Determines whether the SWA contains 
any DDNT records. (A DDNT record 
consists of a series of entries—up 
to 21—each entry identifying a data 
set that 1 s been dynamically 
deallocated since the beginning of 
the job step.) If so, reads the 
DDNT records into the checkpoint 
work area and then writes them to 
the checkpoint data set (except the 
last DDNT record). 

Examines the JSCBOPTS field to 
determine whether any DDNT 
candidates exist. (A DDNT candidate 
is an entry waiting to be put in the 
DDNT record. This condition arises 
because the scheduler only updates 
DDNT records at intervals.) If DDNT 
candidates exist, issues the QMNGRIO 
macro to read each SIOT on the SIOT 
chain. Examines the SI0TBYT1 field 
in each SIOT to determine whether it 
represents a DDNT candidate. If so, 
the candidate is made an entry in 
the current DDNT record in the 
checkpoint work area. When the 
record is filled, it gets written to 
the checkpoint data set and a new 
record is established in the 
checkpoint work area. When all 
SIOTs have been examined, writes the 
last DDNT record to the checkpoint 
data set. 

4 Prepares to read in the JFCB(s) for 
each data set on the user's DSAB 
chain when the CHKPT macro was 

issued. 

For each DSAB, accesses the DD entry 
in the user's TIOT (pointed to by 
the DSABTIOT field) to get the TTR 
of the JFCB associated with the 
DSAB. Stores the TTR in the SMNGRIO 


parameter list. Then issues the 
QMNGRIO macro to read in the JFCB. 

5 If the checkpoint data set is on 
tape, determines whether the 
JFCBVLSQ field in the JFCB equals 0. 
If so, sets the JFCBVLSQ field equal 
to the volume sequence number in the 
DEBVLSQ field of the DEB. If 
JFCBVLSQ is not equal to 0, sets 
JFCBVLSQ equal to DEBVLSQ - 1 + 
JFCBVLSQ. This information is used 
at restart time to position the 
checkpoint data set. 

6 For each data set on the DSAB chain 
when the user issued the CHKPT 
macro, moves the data set's JFCB and 
UCBTYP field to the buffer in the 
checkpoint work area. Issues the 
QMNGRIO macro to read each SIOT 
(pointed to by the DSABSIOT field) 
on the SIOT chain. Moves the ddname 
and other selected fields from the 
SIOT into the buffer in the 
checkpoint work area. Moves the 
DEBVLSEQ field into the DSDR buffer. 
When the buffer is full, writes this 
information to the checkpoint data 
set as a type 1 data set descriptor 
record (DSDR). 

7 If the JFCB associated with the data 
set being processed has extensions, 
reads the JFCB extensions into the 
buffer in the checkpoint work area. 
Each time the buffer is full, writes 
its contents to the checkpoint data 
set as a type 2 DSDR. 

8 When the last JFCB has been 
processed, determines whether 
processing associated with the last 
DSAB has been completed. If not, 
continues processing at step 6. 

9 When the last DSAB has been 
processed, determines whether 
generation data group (GDG) name 
tables exist for any of the user's 
data sets. If so, reads them into 
the buffer in the checkpoint work 
area. Each time the buffer is full, 
writes its contents to the 
checkpoint data set as a type 3 
DSDR. 

10 If no errors have been detected, 
gives control to IHJQCP30. 

11 If errors were detected, sets the 
appropriate error codes (see 
"Diagnostic Aids") and gives control 
to IGC0N06C. 

If EOV occurred for the first time 
on tape, gives control to IHJACP02 
(IGC0206C) to attempt to write a 
complete checkpoint entry on one 
volume. (A tape checkpoint entry 
must be contained on one tape 
volume.) 
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Notes to Diagram 5 (Part 2 of 3) 

IHJQCP30 (IGC0F06C) 

1 Determines from the partition queue 
element (PQE) the starting (CMCESA) 
and ending (CMRGEND) address of the 
user’s region. Establishes a buffer 
for building allocated storage 
record elements (ASREs). 

Determines from the free block queue 
element (FBQE) the boundaries of 
each segment of allocated space 
within the user’s region. 

For each continuous segment of 
allocated space* builds an ASRE. 

(If 255 ASREs are built* writes the 
ASRE* followed by its CIRs* in the 
checkpoint data set* resets the ASRE 
count in the ASR header field to 0* 
and then continues building ASREs.) 

2 Sets a flag in the ASR header field 
indicating that the last ASRE has 
been built. Calls subroutine 
WRITERTN to write the ASR in the 
checkpoint data set. 

Calls subroutine WRITERTN to write 
the CIRs in the checkpoint data set. 
(One CIR is written for each ASRE.) 

If any of the errors listed in 
"Diagnostic Aids" were detected* 
sets a message code and gives 
control to IGC0N06C. 

If EOV occurred for the first time 
on tape* gives control to IGCQ2Q6C 
to attempt to write a complete 
checkpoint entry on one volume. (A 
tape checkpoint entry must be 
contained on one tape volume.) 

IHJQCP31 (IGC0G06C) 

3 Builds the following SUR records in 
the checkpoint data set buffers and 
writes the buffers to the data set 
as each buffer is filled. 

• SPQE* DQEs* and FQEs. These 
control blocks are checkpointed. 
The order is as follows* 

SPQE 

DQE 

all FQEs for this DQE* 
i f any 

DQE (if more) 

all FQEs for this DQE, 
i f any 
etc. 

SPQE 

etc. 

• The JOB pack area ODE queue. 

The CDEs and their associated 
extend lists are checkpointed. 
The order is as follows 2 


Major CDE 

Extent list (if any) 

Minor CDE (if any) 
Major CDE 

Extent list (if any) 

Mi nor CDE (if any) 
Major CDE 
etc. 

• The problem program load list 
element (LLE) queue. 

• The TCB and its extension. 

• The request block (RB) queue, 
which include XSBs. 

• SCB control blocks. 

• FOE control blocks. 

If an EOV occurred for the first 
time on tape* gives control to 
IGC0206C to attempt to write a 
complete checkpoint entry on one 
volume. (A tape checkpoint entry 
must be contained on one tape 
volume.) 

IHJQCP32 (IGC0H06C) 

4 Builds the following SUR records in 
the checkpoint buffers and calls 
IHJCLU00 to write the buffers to the 
checkpoint data set as each buffer 
is filled. 

• Certain fields from the user’s 
checkpoint DCB. 

• User’s general purpose 
registers. 

• DEBs and their associated 
control blocks as follows* 

- IRBs (if present). 

— DEB extension (if present). 

- SAMB (if present). 

— Purge I/O restore list 
(PIRL) (if present). 

- EPCBs (if present). 

— User’s floating point 
registers. 

• TIOT. 

• Selected DSAB information. 

• SPIE SSCRs. If IEAVSPIE 
provides SPIE/ESPIE data* it 
will be checkpointed. 

If an EOV occurred for the first 
time on tape* gives control to 
IGC0206C to attempt to write a 
complete checkpoint entry on one 
volume. (A tape checkpoint entry 
must be contained on one tape 
volume.) 

5 Exits to IGC0N05B. 
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Notes to Diagram 5 (Part 3 of 3) 

IGC0N06C 

1 Determines whether ©n error occurred 
in previously executed processing. 

If so, continues processing at step 

1 in diagram 6. 

2 If any VSAM data sets exist, load 
and branch to VSAM module IDA0I96C. 
See VSAM Logic . 

3 If VSAM SSCR records were generated 
by IDA0I96C, writes each VSAM SSCR 
on the SSCR chain to the checkpoint 
data set. Then frees the storage 
allocated to all SSCRs on the chain. 

4 Searches the DEB chain for subsystem 
data sets. For each one found, gets 
a 4096-byte SSCR. Then initializes 
the SSOB associated with the 
subsystem data set and puts header 
information in the SSCR. Issues the 
IEFSSREQ macro, which will cause the 
SSCR for the subsystem data set to 
be completed. 


Determines whether an error occurred 
generating the SSCR. If so, sets 
error and message codes and then 
continues processing at step 1 in 
diagram 6. If no errors occurred, 
determines whether any data was put 
in the SSCR buffer (there may have 
been no positioning information to 
save). If not, the next subsystem 
data set is processed (if there is 
one). 

5 If there is data in the subsystem 
SSCR, writes the SSCR in the 
checkpoint data set. Frees the SSCR 
buffer before processing the next 
subsystem data set (if there is 
one). 

6 Writes a 4096-byte end record in the 
checkpoint data set. The end 
record, which contains X'FFFF 1 , 
marks the end of the checkpoint 
entry. 

If an error is detected, sets the 
appropriate error and message codes. 

7 Continues processing at step 1 in 
diagram 6. 
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Notes to Diagram 6 

IGC0N06C 

1A Determines whether the DEB just 
processed is the last DEB in the 
chain (DEBDEBAD contains 0 if last). 

IB If so, or if errors were detected, 
deletes VSAM module IDA0I96C (if it 
was loaded) and then gives control 
to IHJACP50 (IGC0Q06C). 

2 Examines the DEB to determine 
whether it is for a TCAM, VSAM, 
subsystem, or ISAM/VSAM 
compatibility interface data set. 

If so, skips processing of this data 
set, gets the address of the next 
DEB in the chain, and continues 
processing at step 1. 


3 Determines whether the user's I/O 
requests were purged by checking the 
DEBUSRPG field in the DEB. If I/O 
was not purged, gets the address of 
the next DEB in the chain and 
continues processing at step 1. 

4 Resumes processing of the user's I/O 
requests by issuing the RESTORE 
macro (with register 1 pointing to 
the address that points to the PURGE 
I/O request list). If any errors 
occur during the RESTORE operation, 
sets appropriate message and return 
codes and issues abend S53F. 

5 Gets the address of the next DEB and 
continues processing at step 1A if 
no errors were detected; at step IB 
if errors were detected. 
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Notes to Diagram 7 

IHJACP50 (IGC0Q06C) 

1 If the checkpoint work area wasn’t 
built (register 1=0), sets up a 
message parameter list containing 
the checkpoint data set’s DCB 
address, jobname, and ddname. This 
list is used by IGC0S06C in building 
messages* Then gives control to 
IGC0S06C. 

If the checkpoint work area was 
built, moves CKRETCD, CKMSGCOD, and 
CKFLAG1 into the message parameter 
list. 

2 If the user canceled the request for 
an automatic restart or if an error 
was previously detected on return 
from VIO (CKMSGC0D=205), zeros 
checkpoint JCT fields (JCTDEVT, 
JCTCKTTR, and JCTCKIDL), blanks out 
JCTCKID1, and turns off the 
checkpoint-taken bit (JCTRSW1) to 
make it appear a checkpoint wasn’t 
taken (so automatic restart won’t 
take place). Continues processing 
at step 9. 

3 If the CHR wasn’t written in the 
checkpoint data set, moves the data 
normally obtained from the CHR into 
the message parameter list for use 
by IGC0S06C in building messages. 
(The data saved is the jobname and 
checkpoint ddname.) Continues 
processing at step 9. 

4 Moves the checkid into the CERCHKID 
field of the SVRB so module IGC0506C 
can get, from the CHR, the other 
information it needs to build a 
message. 

5 If any errors (other than warning 
messages) were detected in 
previously executed checkpoint 
modules, goes to CERSKP2 to prepare 
to write the JCT, and then continues 
processing at step 8. 

6 If the checkpoint data set was using 
BPAM, issues the STOW macro to add 
the current checkid to the 
partitioned data set directory. If 
any errors were detected during the 
STOW operation, sets message code 
026 in the message parameter list. 
Then continues processing at step 8. 

7 Issues the WIJOURN macro, which 
gives control to VIO to save 
checkpoint information in the job 
journal for any VIO data sets open 
when the CHKPT macro was issued. 

(For details of the operation, see 
VIO Logic .) 

8 Updates the following JCT fields* 
JCTRSW1 (indicates checkpoint was 
taken), JCTRSW2 (turns off SYSCHK 


bit in this field, if it is on), 
JCTDEVT (indicates type of device 
checkpoint data set is on), JCTVOLSQ 
(indicates volume sequence number of 
checkpoint data set), JCTCKIDT 
(checkpoint entry identifier), and 
JCTSMRBA (relative block address of 
system message data set). 

9 Branches to CERQW to write the JCT 
to the scheduler work area. If 
errors were detected while writing 
the JCT, sets message code 025 and 
return code X’OC’ in the message 
parameter list. 

10 Restores the user’s block size and 
SYNAD address in the DCB (if the 
user canceled the request for 
automatic restart). 

Issues the FREEMAIN macro to free 
space used by the checkpoint work 
area. If the user did not open the 
checkpoint data set, turns the close 
bit on to indicate that checkpoint 
module IGC0S06C should close the 
data set. 

11 If the user canceled the request for 
automatic restart, returns to the 
user via SVC3. 

IHJACP70 (IGC0S06C) 

12 

a) Issues the GETMAIN macro to 
obtain a 160-byte buffer for 
messages. 

If the return code (CERRETC1) is 
0 or the first byte of the 
message code (CERMSGCD) is not 
0, branches to step 12b to 
format the appropriate message. 
If not, moves a message with the 
following format into the 
message buffer* 

Message parameter list 


CERMSGCD 

CERDDNM 

CERJOBNM 


IHJ000I CHKPT j dd NOT TAKEN xxx 

Continues processing at CMWTO. 

b) If the message code (CERMSGCD) 
indicates the checkpoint entry 
is invalid or an error occurred 
after the checkpoint entry was 
successfully written, moves the 
appropriate message (IHJ001I or 
IHJ002I) into the message buffer 
as follows* 
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TIOT UCB Message parameter list 
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If the return code (CERRETC1) is 
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step 12c. Otherwise, moves 14 
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IHJ005I (jobname* ddname* unit 

name* volume serial number) ENQ5 16 

(checkid) 
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c) Issues WTO to write the message 
at the operator’s console. 

If the first byte of the return code 
(CERRETCO) is X’8’* an I/O error 
occurred during processing 
associated with the RESTORE macro 
(in addition to some other error not 
associated with RESTORE macro). In 
this case* sets up CERRETCD and 
CERMSGCD (with message code 215) to 
print another message. Then 
continues processing at step 12a. 

If the user opened the checkpoint 
data set* examines the DSAB to 
determine whether the security 
interface exists. If so, updates 
certain fields in the user’s DCB 
with fields from the protected DCB. 

Closes the checkpoint data set (if 
it was opened by the checkpoint 
routine) and frees the space used by 
the message buffer. 

Exits to user. 
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DIAGRAM 8. OVERVIEW OF RESTART PROCESSING 
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Notes to Diagram 9 

IHJARSOO (IGC0005B) 

1 Acquires and initializes the work 
areas needed by restart. 

2 Checks that the caller of restart is 
scheduler restart. If not, sets 
error and reason codes and goes to 
IHJARS60 (IGC0V05B) via abend S53F. 

3 Compares the current environment 
with that recorded in the checkpoint 
header record (passed by scheduler 
restart) to see if the environments 
are compatible. If not* sets error 
and reason codes and goes to 
IHJARS60 (IGC0V05B) via abend S53F. 

4 Constructs and opens a DCB for 
reading the checkpoint entry. 


If no errors were detected* goes to 
IHJARS01 (IGC0205B). Else, sets 
error and return codes and goes to 
IHJARS60 (IGC0V05B). 

IHJARS01 (IGC0205B) 

Moves the IQB, ICBs, SAMBs, and 
channel programs to a restart work 
area that is in a subpool owned by 
restart (subpools 250, 251, and 252 
are released by IHJQRS20). 

5 Positions the checkpoint data set to 
the first ASR in the checkpoint 
entry to be restored. 

Goes to IHJQRS20 if no errors were 
detected. Else, sets appropriate 
error and reason codes and goes to 
IHJAR560 (IGC0V05B). 
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Notes to Diagram 10 

IHJQRS20 (IGC0505B) 

1 Determines from the PQE the starting 
address and size of the user's 

region. 

Calls subroutine READRTN, which 
reads the ASR from the checkpoint 
data set. If I/O errors were 
detected, continues processing at 
IHJQRS24. 

Compares the address of the first 
(or next) area to be restored in the 
user's region with the starting 
address of the ASRE in the ASR 
buffer. If they are equal, calls 
subroutine READRTN to read the CIR 
associated with the ASRE into the 
user's region. If the addresses are 
not equal (which means the next 
segment of storage in the user's 
region is unallocated), determines 
the size of the unallocated area and 
issues a FREEMAIN macro to free that 
area and create an FBQE describing 
it. This process continues until 
all the ASREs in the ASR buffer have 
been processed and the user's region 
has been restored. 

If I/O errors were detected when the 
CIRs were read, continues processing 
at IHJQRS24. 

2 Calculates the address of the SUR 
buffer. Calls subroutine RPM500 to 
read the first SUR into the SUR 
buffer. If I/O errors were detected 
when the SUR was read, continues 
processing at IHJQRS24. 

3 (The following discusses the 
restoration to storage of the 
information in one SUR buffer. 

After each control block in the SUR 
buffer is processed, the subroutine 
doing the processing positions to 
the next control block in the 
buffer. When all information in the 
SUR buffer has been processed, 
another SUR is read into the buffer 
and the process is repeated. When 
all SURs have been read, an SSCR (if 
one exists) or an end record is read 
into the SUR buffer.) 

SPQE, DQE, FQE processing: Calls 
subroutine RSGET to get space for SPQEs 
for the system, initiator, and problem 
program TCB. Moves SPQEs from the SUR 
buffer into that space. Puts the 
address of each SPQE chain into the 
REPMAIN work area. 

Calls subroutine RPM500 to move DQEs 
from the SUR buffer into storage. Puts 
the address of each DQE chain in the 
appropriate SPQE. 

Calls subroutine RPM500 to move FQEs 
from the SUR buffer into storage. Puts 


the address of each FQE chain in the 
appropriate DQE. 

If an I/O error was detected in any of 
the processing in this module, sets 
message code 038 in the RSRETCOD field 
in the restart work area and continues 
processing in IHJQRS24. 

IHJQRS21 (IGC0605B) 

Changes the user's SYNAD address so, if 
an I/O error occurs during restart 
processing, control will return to this 
module. 

CDE processing: Calls subroutine RSGET 
to get storage for CDEs and then move 
them from the SUR buffer into acquired 
storage. Puts the address of the CDE 
chain into the REPMAIN work area. If 
bytes 21-23 in the CDE being processed 
contain the address of an extent list, 
moves the extent list into storage and 
puts its new address into the CDE 
associated with it. 

LLE processing: Before processing each 
LLE, determines whether it is associated 
with a CDE for module in the job pack 
queue or link pack area queue. If 
neither (which indicates the end of the 
LLE chain has been reached), continues 
processing at TCB processing. 

Calls subroutine RSGET to move LLEs from 
the SUR buffer into storage. Puts the 
address of the LLE chain into the 
REPMAIN work area. 

If the LLE is associated with a CDE for 
a module on the link pack area queue, 
calls subroutine RPMCDLDR to create a 
CDE for that module. If the entry point 
address for the module has changed since 
the checkpoint was taken, sets message 
code 052 in the RSRETCOD field in the 
restart work area and continues 
processing at IHJQRS24. Otherwise, puts 
the new CDE address in the LLE. 

If the LLE is associated with a CDE for 
a module on the job pack queue, calls 
subroutine RPMJPOS to find the CDE and 
put its address in the LLE. 

TCB processing: Calls subroutine RSGET 
to get storage for the checkpoint TCB 
and its extension and moves them from 
the SUR buffer into the acquired 
storage. Puts the address of the 
acquired storage in the REPMAIN work 
area. 

RB Processing: Calls subroutine RSGET 
to get storage for RBs and their XSBs, 
and then move them from the SUR buffer 
into acquired storage. Puts the address 
of the RB chain in the REPMAIN work 
area. Updates the key mask in the XSBs 
when appropriate. 

For SVRBs and PRBs (except those created 
when the SYNCH macro was issued). 


LY26-3916-1 © Copyright IBM Corp. 1972, 1985 


Method of Operation 27 



determines whether the entry point 
address to the module they’re associated 
with has changed since the checkpoint 
was taken. If so, sets message code 052 
in the RSRETCOD field in the restart 
work area and continues processing at 
IHJQRS24. 
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DEB processing: Adjust the length of 
each DEB. If the DEB is for an ISAM 
data set, converts the address of each 
ISAM extent to an absolute address. 

Moves DEBs from the SUR buffer into 
storage. Puts the address of the DEB 
chain into the REPMAIN work area. 


SCB processing: If the SCB is for a 
STAI control block, rather than a STAE 
control block, bypasses processing. 
Otherwise, calls subroutine RSGET to get 
storage for SCBs and then move them from 
the SUR buffer into the acquired 
storage. Puts the address of the SCB 
chain into the REPMAIN work area. 

FOE processing: Calls subroutine RSGET 
to get storage for FOEs and then move 
them from the SUR buffer into the 
acquired storage. Puts the address of 
the FOE chain into the REPMAIN work 
area. 


Sets up a parameter list for the PGFIX 
macro. Each entry in this list contains 
the beginning and ending address of a 
page described by an FOE. Issues the 
PGFIX macro to fix these pages in 
storage. 

If an I/O error was detected in any of 
the processing in this module or if the 
page-fixing operation was unsuccessful, 
sets message code 038 or 039, 
respectively, in the RSRETCOD field in 
the restart work area and continues 
processing at IHJQRS24. 

IHJQRS22 (IGC0705B) 

Changes the user’s SYNAD address so, if 
an I/O error occurs during restart 
processing, control will return to this 
module. 


Calls subroutine RSBFSTAB to move the 
following information from the SUR 
buffer into the indicated area of 
storage: 


Information Moved 

TCBUSER, TCBPIE, 
and TCBFSA fields 

Save area address 
of problem program 


DCB address and 
block size of 
checkpoint data 
set 

User’s SYNAD 

User’s general 
purpose registers 


Hhere Stored 

Problem program 
TCB 

TQESADDR field 
of initiator 
TQE 

Restart work 
area 


DCB 

SVRB register 
save area 


If the next block in the SUR buffer is 
an IRB (any IRB whose address was in the 
user’s DEB when the CHKPT macro was 
issued was put in the checkpoint data 
set), moves the IRB into storage and 
puts its address in the DEB it’s 
associated with. 

If the IRB contained the address of an 
IQE, converts the address of the first 
available IQE to an absolute address and 
puts the absolute address in the IRB. 

If the next block in the SUR buffer is a 
DEB extension, gets storage and moves 
the DEB extension into that storage. 

Next resets DEBXDSSI in DEBXFLG1 (the 
RACF-protected data set indicator). 
IGC0N05B will set this flag if 
necessary. 

Then updates the DEB with the DEB 
extension address and the DEB extension 
with the DEB address. 

If the next block in the SUR buffer is a 
purge I/O restore list (PIRL), gets the 
length of the PIRL from the DEBUSRPG 
field, issues GETMAIN for storage from 
subpool 254, then moves the PIRL into 
that storage. Updates the DEBUSRPG 
field of the associated DEB with the 
address of the PIRL. 

Moves the contents of the user’s 
floating point registers from the SUR 
buffer into the restart work area. Then 
loads the floating point registers. 

TIOT processing: Moves the TIOT in use 
when the checkpoint was taken from the 
SUR buffer into storage. 

If the next block in the SUR buffer is a 
DSAB with a ddname matching the one 
saved in the DSAB record. If no match 
is found, sets message code 034 (except 
in the case of an implied VSAM catalog 
data set (code X’24’) which does not 
require DSAB updating) in the RSRETCOD 
field in the restart work area and 
continues processing at IHJQRS24. 
Otherwise, updates the DSAB on the chain 
with information saved in the DSAB 
record at checkpoint time. 

Reads into the SUR buffer the next 
record in the checkpoint data set (an 
SSCR record, if there are any, or the 
end record). 

If an I/O error was detected in any of 
the processing in this module, sets 
message code 038 in the RSRETCOD field 
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in the restart work area and continues 
processing at IHJQRS24. 

XHJQRS23 (IGC0805B) 

If 0S/VS2 MVS/System Product is 
installed, move the following fields 
from the checkpoint TCB to the problem 
program TCB: TCBUSER, TCBRTMCT, TCBCAUF, 
TCBFSA. 

Puts the addresses of the SPQE, DQE, and 
FQE chains for the problem program, 
initiator, and system tasks in the 
appropriate TCBs. 

Calls subroutine RPMSWAP to put the 
address of the RB chain for the restored 
problem program in the SVRB used by 
restart. 

Deletes all LLEs associated with CDEs 
for modules on the link pack area queue. 

Calls subroutine RPMSWAP to put the 
addresses of the LLE, CDE, and SCB 
chains in the problem program TCB. 

Puts the address of the DEB chain in the 
restart work area. 

For each CDE, determines whether it f s 
associated with an overlay program. If 
so, stores the address of the note list 
(obtained from the CDE extent list) in 
the segment table (whose address is in 
the extent list). 

Updates the SEGTAB field in the extent 
list with a pointer to either the DCB 
for SY51.JOBLIB or SYS1.LINKLIB, 
depending on which DCB the SEGTAB field 
was pointing to at checkpoint time. 

Puts in each CDE in the CDE chain the 
address of the RB it T s associated with. 
Also, updates the SCB key mask when 
appropriate. 

Puts in each SCB in the SCB chain the 
address of the RB it's associated with. 

Increments the use count (CDUSE field) 
of each CDE for a module on the link 
pack area queue. 

IHJQRS24 (IGC0905B ) 

If no errors were detected in previously 
executed restart modules, continues 
processing at step 5b. 

4 Sets the error pass switch (SWITCH 
field in restart work area) to 1 to 
indicate error processing is to take 
place. The control block chains 
constructed from the checkpoint data 
set and anchored to the REPMAIN work 
area have not been attached to the 
problem program TCB (because the 
restart was found to be unsuccessful 
before swapping took place in 


IGC0805b) and therefore must be 
freed. 

Calls subroutine FREEM to free 
SPQEs, DQEs, and FQEs (whose 
addresses are in the REPMAIN work 
area) for the system, problem 
program, and initiator tasks (only 
DQEs and FQEs for owned subpools are 
freed). 

Calls subroutine FREEM to free the 
CDE, LLE, RB, SCB, and FOE chains 
whose addresses are in the REPMAIN 
work area. 

If the error pass switch is 0 
(indicating no errors were detected 
in previous modules) and a SPIE SSCR 
is in the SUR buffer, calls the SPIE 
routine to reestablish the SPIE 
environment. Continues processing 
at XCTLA. 

5 

a) When the last SPQE has been 
processed, continues processing 
at R8B0 to free up control block 
chains anchored to the REPMAIN 
work area. These represent the 
restart task’s control blocks 
because the problem program’s 
control block chains (obtained 
from the checkpoint data set) 
were successfully attached to 
the TCB via swapping in 
IGC0805b. 

b) If the SPQE for the problem 
program (address in TCBMSS field 
of TCB) is not for subpool 0 and 
is a shared SPQE, continues 
processing at step 5e. 

c) If the task is in real storage, 
continues processing at step 5d. 
Otherwise, calls subroutine 
FINDPAGE to get an external page 
table entry (XPTE). Sets the 
storage protect key in the XPTE. 

d) If the page is in storage, sets 
the storage protect key in both 
parts of the page described by 
the DQE associated with the SPQE 
and turns on the fetch protect 
bit for all subpools except 252. 

If the storage described by the 
DQE is made up of multiple 
pages, continues processing at 
step 5c. 

e) Continues processing at step 5c 
for all DQEs on the chain. Then 
accesses the next SPQE and 
continues processing at step 5a. 

If any errors were detected, 
gives control to IGC0V05b. 
Otherwise, gives control to 
IGC0G05B. 
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DEB chain 


DEBDEBAD 


DEBDCBAD 


DEBXDSAB 


DSABCHN 


DSABFLG4 


TIOT (old) 


TIOEDDNM 


TIOEJFCB 


From Dia. 10 


1 Counts DEBs and gets DSTAB and SEGTAB 
s 


2 The following operations are performed for each 
data set open when the user issued the CHKPT 
srnacro: 

* * Ruilrlc flats rat antrw 



TIOEDDNM 


TIOEJFCB 


Data set entry 


From TCAM 

module 

IGC0J05B 



^ Builds data set entry, i - — 

Error detected? Yes 

3 If TCAM data sets exist, is TCAM message 
control program loaded? 

Yes ■■■■■■■■ 

No 



Restart work area 
RSSVERRG 
RSERMODN 
RSERDDND ’ 


RSERDDNT 


RSRETCD1-4 


RSMSGCD1-4 


RSDSTPTR 



To TCAM module 

IED0J05B 

(see ACF/TCAM 

Diagnosis 

Reference) 


Error detected? Yes 


■Ha 


To exit 
processing 


| TABSEGAD 


SEGTAB 

Control 

Information 


JFCB 

JFCB 

Extension 


-foiX 

us/ 


To exit 
processing 


4 Sets indicators for types of data sets found. 

5 After all data set entries have been built; 
exits according to the following: 

Dummy data j 
set exists 

Nondirect access 
data set exists 1 

Direct access 
data set exists * 



DiaX To process 
12/ dummy data sets 

DieX To entrance A to process 
13/ nondirect access data sets 

DiaX To part 1, entrance A, to process 
14/ direct access data sets 
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Notes to Diagram 11 
XGC0G05B 

1 Determines the number of data sets 
open when the checkpoint was taken 
by counting the number of DEBs in 
the DEB chain. Gets work space in 
which to build a 48-byte data set 
entry for each of these data sets. 

Moves the DCB address for each of 
these open data sets from the 
DEBDCBAD field of the DEB to the 
TABDCBAD field of the data set 
entry. 

Tests the DEBNMSUB field of each DEB 
for a TCAM data set. If one is 
found, sets RSFLAG2 in the restart 
work area and TABFLG1 in the data 
set entry (special processing is 
subsequently done on TCAM data 
sets). 

2 Compares ddnames in the new (restart 
time) and old (checkpoint time) 

TIOT. If a match is found, stores 
the offset (in new TIOT) in the 
DCBTIOT field of the DCB. Then 
moves the TTR of the JFCB from the 
new TIOT to the TABJFCB field in the 
data set entry. 

If no match is found, sets message 
code 020 in the restart work area 
and gives control to IGC0V05B. 

3 For each data set open when the 
checkpoint was taken, searches the 
D5AB chain for a match on the 
DSABTIOT field. When a match is 
found, puts a pointer to the 
matching DSAB in the data set v s DEB 
extension. 

For each subsystem data set open 
when the checkpoint was taken, 
updates the name of the subsystem 
data set in the SSIB and puts the 
address of the DEB in the SSOB and 
the address of the SSOB in the DEB. 

4 Before verifying security, examines 
the DSABFLG4 field in each DSAB on 
the DSAB chain to determine whether 
the DSAB represents a checkpoint 
data set. If so, determines whether 
it is the checkpoint data set being 
used for restart; if it is, sets 
TABFLG3 field in the data set entry. 

Determines from the DSABFLG4 field 
whether the security interface has 
been invoked for the checkpoint data 
set to be used for restart. If so, 
stores the DEB address in the user’s 
DCB. 

Determines from the D5ABFLG4 field 
whether the checkpoint data set to 
be used for restart is on a secure 
volume. If not, sets message code 
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218 in the restart work area and 
gives control to IGC0V05B. 

5 Divides the remainder of the restart 
work area into a series of 304-byte 
buffers. Puts the address of one of 
the buffers in the TABSEGAD field of 
each data set entry (multiple 
buffers allow I/O to be overlapped). 

IGC0G95B 

Sets up a QMNGRIQ parameter list and 
then issues the QMNGRIO macro to 
read the JFCB into the buffer. 

If I/O errors were detected when the 
JFCB was read, sets message code 024 
in the restart work area and gives 
control to IGC0V05B. 

Makes device type and data set 
organization tests to determine the 
specific JFCB data to be put in the 
data set entry. Puts this 
information, and the volume 
identification of the specific 
volume to be positioned, in the data 
set entry. (At this point, each 
data set entry for a sequential data 
set residing on five or fewer 
volumes will contain the information 
necessary for positioning the data 
set prior to restart. Otherwise, 
TABFLG2 is set with X f 8Q f indicating 
that there are more than five 
volumes and further processing will 
be done in IGC0I05B.) 

6 Searches the DEBAMTYP field of each 
DEB in the chain to determine 
whether the data set is a dummy 
ISAM/VSAM compatibility interface 
data set. If so, sets an indicator 
in the TABFLG2 field in the data set 
entry. 

7 Calls IGC0J05B if there are any TCAM 
data sets to restart. 

8 Searches the DSABFLG3 field of each 
DSAB in the chain to determine 
whether the data set is a VIO data 
set. If so, sets an indicator in 
the RSDCBFLG field in the restart 
work area and in the TABFLG2 field 
in the data set entry. 

XGC0I05B 

9 Examines the TABFLG2 field in each 
data set entry to determine if the 
data set is on six or more volumes. 

If so, uses the volume sequence 
number in the TABVLID5 field of the 
data set entry to determine the 
number of JFCB extensions to be 
accessed on SWA to get the correct 
volume serial number for 
positioning. 

When the correct JFCB extension is 
in storage, gets the appropriate 
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volume identification from it and 
stores it in the TABVLID1 field of 
the data set entry. 

If errors were detected when the 
FJCB extension was accessed, sets 

positioning of data sets. 


message code 024 in the restart work 
area and gives control to IGC0V05B. 

10 When the last data set entry has 
been processed, determines which 
module to transfer to for 


32 Checkpoint/Restart SVC Logic 


LY26-3916-1 


© Copyright IBM Corp. 1972, 1935 



Restricted Materials of IBM 
Licensed Materials - Property of IBM 

This page intentionally left blank. 


LY26-3916-1 


© Copyright IBM Corp. 1972, 1985 


Method of Operation 33 



34 Checkpoint/Restart SVC Logic LY26-3916-1 © Copyright IBM Corp. 1972* 1985 


Subroutine 

names 


DCBIOBL 
DC BIO BA 
DCBMACRF 
DCBOFLGS 


The following operations are performed for each 
dummy data set (except 1SAM/VSAM Cl data sets) 
that was not dummy when the user issued the 
CHKPT macro: 

1 Deletes associated access method routines. 
Unchains DEB. 

Error detected? Yes 

2 Frees IOB space. 

3 Builds dummy DEB and puts it on 
DEB chain. 

4 Loads dummy access method module.^ 

5 Exits according to the following. 

Nondirect-access 
data set exists I 


Restart work area 
J RSRETCD1-4 1 


^ DCBCNTRL 
DCBREAD 

To entrance A to 
process nondirect- 
access data sets 

To part I, entrance A, to 
process direct-access 
data sets 
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Notes to Diagram 12 

IGC0H05B 

For each dummy data set found, 
determines (from DEBEXSCL field in 
DEB) if it Mas a dummy data set when 
the checkpoint Mas taken* If it 
Mas, bypasses the data set entry and 
processes the next one. 

1 If the dummy data set Mas not a 
dummy data set Mhen the checkpoint 
Mas taken, gets the names of the 
access method routines associated 
Mith it and deletes these routines, 
unless the data set Mas a SY5IN or 
SYSOUT data set. 

Takes the DEB off the DEB chain. 

2 Frees the IOB space created Mhen the 
data set Mas originally opened. 


3 Gets storage and builds a dummy DEB. 
Stores the DEB address in the DCB 
and puts the dummy DEB on the DEB 
chain. 

4 Loads the dummy access method module 
(IGC019AV) and puts a pointer to it 
in the DCB. 

If no errors Mere found, processes 
the next data set. 

5 If no errors Mere encountered, goes 
to the next module as folloMs* 

a) IGC0K05B, if any nondirect 
access data sets to restart. 

b) IGC0M05B, if no nondirect access 
data sets. 

If any errors Mere detected, sets 
the appropriate error and reason 
codes and goes to IHJARS60. 
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CM 

os 


TIOT 



£ 

3 

DD - *] 


entry! 
(1) \ 

UCB address 


•t 

DD j 
entrv 1 


ci i ti y i 

(n) | 

UCB address 


From Dias. 11,12 


UCB 


SRTEVOL1 


X: 


DCB 


DCBTIOT 


ia. 14^m 


Data 
set entry 


TABFSFNS 


TABBLK1 


i? 


SWA 




Requests that tape volumes be mounted and verifies 
them. Errors detected? Yes £_ 

Any direct access data sets exist? Yes, 


From Dia. 

(part 11 - -2 

.! I 



From Dia. 14 

(part 1)_ 

Restart work ar ea 3 

TABDCBAD | ^1 \W^ 


For each QSAM card reader data set, primes 
the input buffer. 

Any direct access data sets exist? Yes 

Positions each tape data set (except DOS and 
those with bypass leading tapemarks). 

Verifies IBM standard tape labels. 

Verifies password. 

Errors detected? Yes? 




Verifies status of checkpoint data sets via 
call to IGC0Q05B. 

Any DOS tape data sets exist? 


Any direct access data sets exist? yes 

No_ 

Positions tape data sets with leading tapemarks 
to be bypassed and DOS data sets with 
embedded checkpoint records. 

Errors detected? 


Yes 


(£f 


Any direct access data sets exist? Yes 

Nof 



Restart work area 



To part 1, entrance A, to process 
direct access data sets 


To part 1, entrance B, to process 
direct access data sets 


To exit processing 


To part 2, entrance A, to process 
direct access data sets 

To part 3, entrance B, to process 
BP AM data sets and begin exit 
processing 

To exit processing 

To part 2, entrance A, to process 
direct access data sets 

To part 3, entrance B, to begin 
exit processing 


M 


jo 

o 

o 
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Notes to Diagram 13 

IGC0K05B 

1 Searches the data set entries for 
SYSIN* SYSOUT* unit record* and 
graphic data sets. For each one 
found* updates the UCB address in 
the DEB. 

For tape data sets* ensures that: 

a) The correct volumes are mounted. 

b) The correct label information is 
in the UCB. 

c) User is authorized to use the 
tape volumes. 

d) Nonstandard label processing is 
done for nonstandard labels. 

For the tape data sets* DEQ at 
demount is indicated in the JFCB and 
the user is APF authorized* sets the 
corresponding indicator in the UCB 
and DEQs all the volumes in the JFCB 
up to* but not including* the 
current volume. 

If any errors are found* sets the 
appropriate error and reason codes 
and goes to IHJARS60. 

If any direct access data sets 
exist* goes to IGC0M05B* else goes 
to IGC0L05B. 

IGC0L05B 

2 Searches through the data set 
entries for QSAM card reader data 
sets. 

For each one found* calls the EOB 
subroutine to prime the input 
buffers. 

Exits to IGC0N05B. 


IGCOSOSB 

3 Ensures all tapes are correctly 
positioned except for DOS tapes and 
those with bypass leading tapemarks. 

Calls IGC0Q05B to verify checkpoint 
data sets. 

If password protection is specified 
and the volume was not found to be 
RACF protected* requests that the 
operator enter the correct password 
before processing continues. 

Exits to IGC0005B. 

IGC0Q05B 

4 The status of the data set i s 
verified by asking the operator* and 
if the checkpoint and restart 
security status of the data set are 
not the same* sets the appropriate 
error and reason codes and goes to 
IHJARS60. 

If the checkpoint and restart status 
are the same* control is returned to 
the caller. 

If any errors were detected* sets 
the appropriate error and reason 
codes and goes to IHJARS60. 

IGC0U05B 

5 Searches through the data set 
entries. For each tape data set 
indicating leading tapemark or 
embedded DOS checkpoint records* 
repositions the data sets to the 
correct file and record. 

6 If any direct access data sets 
exist* exits to IGC0R05B. Else* 
exits to IGC0T05B. 

If any errors were detected* sets 
the appropriate error and reason 
codes and goes to IHJARS60. 
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Notes to Diagram 14 (Part 1 of 3) 

IGC0M05B 

1 Searches through the data set 
entries for data sets on direct 
access and ensures that the correct 
volume or volumes for the data set 
are mounted. 

If any error was detected, sets the 
appropriate error message codes and 
goes to IHJARS60. 

2 If any nondirect access data sets 
exist, gives control to IGCOL05B. 
Else, exit to IGC0N05B. 

IGC0N05B 

3 If VSAM SSCRs exist, reads them from 
the checkpoint data set into the 
restart work area. 

If a VSAM SSCR exists, VSAM restart 
module IDA0C05B is loaded and 
branched to for SSCR and initial 
VSAM DEB processing (see VSAM 
Logic ). 

4 If subsystem SSCRs exist, reads them 
from the checkpoint data set into 
the restart work area. Sets the 


restart flags in the subsystem's 
SSOB block. Then issues the 
IEFSSREQ macro, which gives control 
to JESSSREQ (subsystem request 
routine) to process the subsystem 
SSCRs. 

5 Searches through the data set 
entries for data sets that are 
password or RACF protected and 
verifies the user's authority to use 
the data set. 

If the user isn't authorized, links 
to IGCMSG6C to write message 
IHJ101I, sets error and message 
codes, and passes control to 
IHJARS60 (IGC0V05B). 

If JSCBPASS is set, the RACF 
security checks are bypassed. 

If any errors are detected, sets the 
appropriate error codes and goes to 
IHJARS60 . 

Exits to IGC0S05B if any tape data 
sets exist, or to IGC0R05B if any 
direct access data sets exist. 

Else, exits to IGC0T05B. 
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Restart work area 


From 
Dia. 13 



Reads identifier DSCB for each data set 
(except VIO, SAM subsystem interface, 
ISAM, and BPAM concatenated). 


Error? Yes 


0anE^. 


0=F> 


Updates number of extents in DEB or DSCB 
for each data set (except BDAM) and acquires| 
DASD space for MSS (Mass Storage System) 
volumes. 

Errors detected? 

Yes I 


£1 


Any ISAM or BDAM data sets 
to be positioned? ■■■■I 
No Hi 


jDiaX To exit 
15/ processing 


- jDia\ 

fVV 


To part 3, entrance A, 
* to process ISAM and 
BDAM data sets 




. To part 3, entrance B, to 
process BPAM data sets 
' and begin exit processing 



to i 


QJ O 

I— r+ 

w to 
a. 
I 
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Notes to Diagram 14 (Part 2 of 3) 
IGC0R05B 

1 Searches through the data set 
entries for data sets on direct 
access devices (except for 
noncheckpoint VIO data sets, SAM, 
subsystem interface (SYSIN/SYSOUT), 
ISAM, and BPAM data sets that are 
concatenated). 

If the data set being processed is a 
checkpoint data set, updates those 
fields in the DOB containing the 
MBBCCHHR and the number of bytes 
remaining on the track* 

2 Compares the number of extents 
recorded in the DEB and DSCB. If 
they're equal, updates the DEB. 


If the DSCB indicates more extents 
than the DEB and the data set is an 
output data set, gives control to 
the DADSM partial release routines 
to release all tracks after the last 
track for the last extent recorded 
in the DEB. 

If the DEB indicates more extents 
than the DSCB and the data set is an 
output data set, moves the ending 
track address from the last extent 
in the DSCB to the last extent in 
the DEB. 

If any errors were detected, sets 
the appropriate error codes and goes 
to IHJARS60. 

3 Exits to IGC0W05B if any ISAM or 
BDAM data sets exist. Else, exits 
to IGCOT05B. 
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Restart work area From Dia^ 
I „ ' _ * I 14 (part I T 


ISAM work area 


Data 
set entry 
(I) 


Data 
set entry 
(n) 


TABFLG1 


TABDSORG 


TABFLGI 


TABDSORG 


VTOC 

■dscbJ 


DEB chain 


DEBDEBAD 

DEBUSRPG 


Subroutine 

list 


BDAMTABL 


• > 1 Last data set entry been processed? Yes Ce 


_■_^ BDAM data set entry? Yes 

-*-> ISAM data set entry? No 

I 2 Sets up ISAM work area. 

I 3 Reads ISAM DSCB. C l = = 

y/f 4 Calls ISAM open executors. (g^EB& 
I I/O error detected? Yes 


From Dias 
13 . 14 
(part I 


S Gets work space for each BDAM data set that 
has an exclusive control list. ™*™m*** 



rr_ i 


_ / 


- >6 Last data set entry been processed? YesQ 

®-f> BPAM data set entry? No^ 

~ > 7 Reads in directory. » 

Error detected? Yes 
8 Last member in directory? Yes 

/ -Member added after checkpoint taken? No^ 

| 10 Deletes member, 

j Error detected? Yes 

10-^n Reschedules processing of any I/O requests that 
I were purged. 

I 1 2 Any VSAM control Yes 

I blocks? 


To exit 
processing 


Restart work area 

4 RSRETCOD I 


Directory 


BDAM DEB 


To VSAM 

module 

IDA0A05B 


DCBRELAD 


To exit processing 


Directory 
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Notes to Diagram 14 (Part 3 of 3) 
IGC0M05B 

1 Searches for ISAM and BDAM data set 
entries. 

2 For each ISAM data set found, gets 
an ISAM work area (key 5) and 
prepares it for use by the ISAM open 
executors. Gets the UCB and disk 
address of the data set f s ISAM 
(format 2) DSCB. Builds the IOB and 
channel program used to read the 
DSCB. 

3 Reads the ISAM (format 2) DSCB into 
the ISAM work area. Then copies the 
ISAM DCB into the ISAM work area. 

4 Loads and goes to the ISAM open 
executors IGG01920 (for fixed-length 
records) or IGG01950 (for 
variable-length records) to open the 
ISAM data set. 

5 For each BDAM data set that has an 
exclusive control list, gets space 
in subpool 230 (key 5). Then stores 
the address of this space in the 
BDAM DEB extension. 

If any errors were detected, sets 
the appropriate error codes and goes 
to IHJARS60. 

Exits to IGC0T05B. 

IGC0T05B 

6 Issues the DEBCHK macro for each 
data set open when the CHKPT macro 
was issued. This causes the DEB 
address for each of these data sets 


to be added to the DEB table. If a 
DEB is found to be invalid, an abend 
16E will be issued by DEBCHK. 

Searches through the data set 
entries for BPAM data sets that were 
open for output when the checkpoint 
was taken. 

7 Builds the control blocks (DEB, ECB, 
IOB) and channel program necessary 
for reading the BPAM directory. 

Reads each block of the directory 
into the restart work area. 

9 Determines whether any of the 
members of the directory were added 
after the checkpoint was taken. 

10 Issues the STOW macro to delete any 
members in the directory that were 
added after the checkpoint was 
taken. 

11 Examines each DEB (except those for 
TCAM, subsystem, or compatibility 
interface data sets) to determine 
whether the user I/O requests 
associated with the data set were 
purged. If so, issues the RESTORE 
macro to reschedule I/O processing. 

12 If a VSAM SSCR was read from the 
checkpoint data set, module IDA0A05B 
is loaded and branched to (see VSAM 
Logi c ) . 

If any errors were detected, sets 
the appropriate error codes and goes 
to IHJARS60. 

Else, control is passed directly to 
IHJARS60 (IGC0V05B). 
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From Dias. 9,10,11,12, 13, 
14 (parts 1, 2, and 3) 
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Notes to Diagram 15 

IHJARS60 (IGC0V05B) 

1 If any errors were detected in 
previously executed restart modules, 
continues processing at RERABEND. 

Restores the user’s checkpoint data 
set block size in the DCB. 

2 Issues the FREEMAIN macro to free 
all but the message portion of the 
restart work area. 

Calls subroutine RERUJTQ, which moves 
the message for successful restart 
into the message buffer and prints a 
message of the following format** 

TIOT 


I TIOCNJOB 

f 

IHJ008I job name RESTARTED 


3 Frees the remainder (message 

portion) of the restart work area. 


If the checkpoint data set is on 
tape, sets the volume sequence 
number in the VOLSEQNO field in the 
DEB to 1 for automatic restarts. 

4 If the security interface exists (an 
unauthorized user was taking 
checkpoints), updates the user's DCB 
from the protected DCB. 

5 Closes the checkpoint data set and 
returns control to the problem 
program with a return code of 4 
(indicating successful restart) in 
register 15. 

6 Calls subroutine RERUTO, which moves 
the message for an unsuccessful 
restart into the message buffer and 
prints a message of the following 
format* 

TIOT Restart UCB 

work area _ 

TIOCNJOB I I RSRETCOD I I UCBNAME 

V 7 I 

HJ007I RESTART NOT SUCCESSMJL job name /message unit \ 

\ code, name / 


and issues abend code S13F. 
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PROGRAM ORGANIZATION 


This section shows the flow of control between 

checkpoint/restart modules and the major operations performed by 
each module. 

The on- and off-page connectors from one flow diagram to the 
next contain an alphabetic character and a number, thus- 



The alphabetic character corresponds to the alphabetic character 
assigned to each diagram (Diagram A, Diagram B, and so forth). 
The number refers to an entry point on the page for that 
diagram. 

Diagrams A and B show the checkpoint modules. These modules are 
executed after an SVC 63 instruction (CHKPT macro) is issued. 
When the SVC 63 instruction is executed, an SVC interruption 
occurs and control passes to the SVC FLIH, the SVC SlIH, and 
then to the first checkpoint load module. 

Diagrams D through G show the restart modules. These modules 
are executed after an SVC 52 instruction is issued. Before this 
instruction is issued, the job management routine, IEFXB609, 
processes the job's SWA entries to ensure that the job f s device 
allocation environment is the same as it was at checkpoint time. 
Before exiting, IEFXB609 changes the name of the program to be 
executed to IEFRSTRT. 

IEFRSTRT consists only of an SVC 52 instruction. When this 
instruction is executed, an SVC interruption occurs and control 
passes to the SVC FLIH, the SVC SLIH, and then to the first 
restart load module. 
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DIAGRAM A 


From 

IGC0206C 


CHKPT macro 
(SVC 63) 


Returns Yes IGC0006C: Housekeeping 

to.user <^§^3 !• Were checkpoints suppressed? 
(SVC 3) 

• Was automatic restart canceled? ■ 

• Opens checkpoint data set if user 
didn't open it. 

• Builds checkpoint work area. 

• Tests security of checkpoint data 

x/ set. 

Yes 

■■■■ • Errors detected? 


From I 
IGC0H060, |Yes 
G06C 


From 

IGC02C6C . 


IGC0I06C: Housekeeping 
!• Errors detected? 


IGC0206C: Housekeeping 

• Reads user's JCT into checkpoint 
work area. 

!• Was automatic restart canceled or 
an I/O error detected? 

• Updates JCT to reflect number of 
checkpoints taken and generates 
chcckid if necessary. 

• Builds CHR. 

• If any VSAM data sot is open. ■ 
call IDA0C06C 


Any errors? 


To VSAM module 
IDA0C06C (see 
VSAM Logic) 


IGC0506C: Purges I/O 

• Purges user’s I/O requests. 

• Issues ESTAE to provide a 
recovery environment. 

• Stops activity in user’s address 
space. 

• Verifies address of checkid and 
checkpoint data set’s DCB. 

• If entered from R/TM, issues 
STATUS macro to start dis¬ 
patching SRBs if necessary. ■ 

• Errors detected? 


IGC0A06C: Takes checkpoint No 

• Are DHBs valid? 

• Writes CHR in checkpoint data set. Yes 

I/O error? ■■■■ 

!• Did EOV occur on tape for the 
first time? 

• Did EOV occur on tape for the Yes 

second time or on disk? 


IGC0D06C: Takes checkpoint 

• Writes DDNT records in the 
checkpoint data set. 

• For each user data set represented 
by a DSAB on the user’s DSAB 
chain, builds and writes DSDRs in 
the checkpoint data set. 

I/O error? 

!• Did EOV occur on tape for the 
first time? 

• Did EOV occur on tape for the 
second time or on disk? 


IGC0F06C: Takes checkpoint 

• Builds and writes ASRs in the 
checkpoint data set. 

• Writes CIRs in the checkpoint 
data set. 

• I/O errors? 

!• Did EOV occur on tape for the 
first time? 

• Did EOV occur on tape for the 
second time or on disk?^^HBi 
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IGC0G06C: Takes checkpoint 

• Builds and writes in the checkpoint 
data set SURs containing the 
following system control blocks: 

SPQEs* DQEs* FQEs, CDEs, 

LLEs, RBs* SCBs, and FOEs. 

I/O errors? 

!• Did EOV occur on tape for the first 
time? 

• Did EOV occur on tape for the 
second time or on disk? ■■■■i 


IGC0H06C: Takes checkpoint 


• Builds and writes in the checkpoint 
data set SURs containing selected 
fields in the TCB and checkpoint 
work area, DEBs, IRBs. DEB 
extensions, PIRLs, user's floating 
point registers, TIOT table, and 
selected DSAB fields. 

• Builds and writes in the checkpoint 
data set SPIE SSCRs. 

ft* Did EOV occur on tape for the first 
time? 


Sets error codes for I/O errors* 
second tape EOV* or disk EOV. 


From 

IDA0I96C 


IGC0N06C: Takes checkpoint and 
restores I/O 

• Calls IDA0I96C to process VS AM — 
data sets. 

I Errors detected? 

• Writes any VSAM SSCRs in the 
checkpoint data set. 

• Builds subsystem SSCRs. 

I Errors detected? 

• Writes any subsystem SSCRs in the 
checkpoint data set. 

• Writes end record in checkpoint 
data set. 

• Restores processing of user's I/O 

requests._ 


From 

IGC0006C, 
106C, 206C, 
N06C 


IGC0Q06C: Exits _I 

I* Was checkpoint work area built? f 

• Prepares parameter list used in 
writing messages. 

• Determines whether checkpoint was 

taken successfully. | 

• Issues WIJOURN macro to save 
checkpoint information (on the 
job journal) for any VIO data 
sets. 

• Updates JCT and writes it in SWA. 

• Was automatic restart canceled? M 


IGC0S06C: Exits 


• Issues a message indicating whether 
checkpoint was taken successfully. 

• If checkpoint routines opened the 
checkpoint data set, closes it. 

• Puts a return code in register 15. I 


- To VSAM module 
IDA0196C (see 
VSAM Logic ) 


Returns to user 
(SVC 3) 
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DIAGRAM C 


IEFRSTRT 
(SVC 52) 



IGC0005B: Housekeeping 


Errors detected? i 

Gets storage for restoring the 
problem program. 

Builds restart work area. 

Opens the checkpoint data set. 


Yes | 


IGC0205B: Housekeeping 


Positions the checkpoint data set 
to the first ASR. 


I 


IGC0505B: Restores user's region 
and task control 
information 


Reads ASR from the checkpoint 
data set. 

Reads CIRs from the checkpoint 
data set 

Reads SURs, containing SPQEs, 
DQEs, and FQEs, from the 
checkpoint data set; restores SPQE, 
DQE, and FQE chains. 

I/O errors? 


Yes 


IGC0605B: 


Restores user's region 
and task control 
information 


Reads SURs from checkpoint data 
set and restores: 

- CDE chains and extent lists 

- LLE chains 

- RB chains 

- SCB chains 

- FOE chains 

Fixes the pages described by each 
FOE. 

I/O errors? 




Yes 


Yes 


From IGC0605B 



IGC0705B: 


Restores user’s region 
and task control 
information 


Reads SURs from checkpoint data 
set and restores: 

- Selected TCB and DCB fields 

- General registers 

- DF.B chain and IRBs associated 
with DFBs 

- DI B extensions 

- PIRLs 

- User’s tloating point registers 

- Old HOT 

- Selected DSA B fields 

Reads next record from checkpoint 
data set (either an SSCR or the 
end record). 


Errors detected? 

' i 


IGC0805B: 


Restores user's region 
and task control 
information 


Attaches SPQE, DQE, and FQE 
chains to the system, initiator, 
and problem program’s TCB. 

Attaches LLE and CDE chains to 
the problem program's TCB, the 
RB chain to restart’s SVRB, and 
the DEB and SCB chains to the 
restart work area. 

Restores RB address within each 
CDE and SCB. 

Adjusts the use count field in 
each CDE. 


3 


IGC0905B: Processes errors 


• If any errors were detected in 
previous restart processing, frees 
user’s region and control block 

• If SP1E SSCR is in SUR buffer, 
calls SPIE routine to process it. 

• If no errors were detected in 
previous restart processing, restores 
storage protection keys and frees 
control blocks not needed to 
restart the problem program. 



IGC0G05B: Builds data set entry 

No 

• For each non-VSAM user data 
set, builds a data set entry in the 
restart work area. 

• Checkpoint data set on secure 

• Builds buffers for reading JFCB. 

~1 ^ 
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DIAGRAM D 


rom IGCOGOSB 


Irom JGC0H05B. 
105 B p \ 


IGC0G95B: Builds data set entry 

• Reads the JECB for each user data 
set into the restart work area. 

I/O errors? 

• Sets indicator if any dummy 
l&AM/VSAM compatibility 
interface data sets exist. 

• Sets indicator if any VIO data 
sets exist 

I • Any TCAM data sets open when 
the checkpoint was taken? 

• Is TCAM message control program 
loaded? 


IGC0K05B: Procesaes nondircct 
access volumes 

• Requests that tape volumes 
(except the checkpoint data set 

to be used for restart) be mounted 
and verifies them. 

• Checks RACF authorization to 
tape volumes, 

• Updates DEBs for SYSIN.^^HI 
SYSOUT, unit record, and graphics 
data sets. 

!• F.nors detected? 

• Does a user data set exist on a 


From 

TCAM 

module 

IGC0J05B 


To TCAM module IED0J05B 
(see OS/ VS TCAM Logic or 
ACF TCAM Logic) 


1GC0105B: Builds data set entry 

• For each-user data vet on six or 
more volumes: 

Reads JECB extensions from 
SWA into restart work area. 
Moves volume identification of 
volume being processed at 
checkpoint time into the first 
volume identification field in 
the data set entry. 

• E rrors dctcctcd?MH^HHHMBMi 

• E xits according to the following: 

No dummy data set exists but 
a nondircct access user data set 
exists. 

l_ No dummy data set exists. 


IGC0M05B: Mounts/verifies direct 
_ access volumes _ 

• Requests that direct access 
volumes (except for VIO data sets 
and the checkpoint data set to be 
used for restart) be mounted and 
verifies them. 

Errors detected? 

• Are all user data sets on a DASD? 





IGC0L05B: Processes QSAM card 
reader data sets 


• Primes the input buffer*for all 
OSAM card reader data set*. 

• Errors detected? 



IGC0H05B: Processes dummy data 
sets 

• Builds dummy DEB for any BSAM 
or QSAM data set open when 
checkpoint was taken if data set 
was specified as 1)1) DUMMY on 
deferred restart. 

• Deletes BSAM or QSAM routines 
for these data sets (unless data 
sets are SYSIN/SYSOUT) and loads 
dummy access method module. 

Error detected? ■■■■■■ 

j • Does a nondirect access user data 
exist? 


unauthorized 


IHJCMM00 
.IHJ1021 MSG 
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DIAGRAM E 


From 
IDA0C05B 


From 

JESSSREQ 


From 

IGCOQOSB 

fF7 


-From IGCOMOSB, 
LOSS 


E>1 


IGC0N05B: Processes direct access 
data sets 


• If VSAM SSCRs exist, reads them 
from checkpoint data set and calls 
IDA0C05B _ 

Errors detected? ■■■■■■■■■■ 


If subsystem 5SCR exists, reads it 
from checkpoint data set. \ 

For each user data set on a 
DASD: 

- Gets the data set name and 
VTOC address. 

- Builds a channel prof ram. 

- Verifies RACF authorization 
not authorized 


- If data set should have password 
supplied, calls SECLOA DA 
(of O/C/EOV) to request 
password. 

Verifies status of checkpoint 
data set 

• Errors detected? 


b{£> b(u> 


Yes 


E> 


►To 

mibsystem 

request 

routine 

iESSSREQ 


^ To VSAM module 
IDA0C05B 
(see VSAM Logic) 


IHJCMMOO: Message module 


• Prints message IHJI Oil 


From 1GC0S05B 


IGCOQOSB: 




Verifies status of 
checkpoint data sets 


• If not VIO, ask operator if volume 
is secure. 

• If checkpoint and restart status 
are the same, return to caller. 

• Error exit. 4 
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From 1GC0L05B 


From IGC0N05B, 
P05B, S05B, 
U05B _ 


IGCGP05B: Prepares to position 
tape data sets 

• Builds work areas used in 
positioning tape data sets. 

• No tape data sets were found but 
direct-access data sets exist.HMI 

• No direct-access or tape data sets 
exist. 


IGC0S05B: Positions tape data sets 

From • Verifies IBM standard tape labels 

1GC0Q05 B and verifies password. 

• Verify status of checkpoint data 

F4 - sets. 

• Positions each tape data set to the 

Y es correct record. 

n # Errors detected? 

• Do any of the tapes either have a 
leading tapemark or contain 
embedded DOS checkpoint 
records? 

• Do any user data sets exist on \ 
DASD?— Ill jl — IM1 


IGC0R05B: Processes direct-access 
data sets (except BDAM, 
_ BPAM, and ISAM) 

• Updates DCB for checkpoint data 
set. 

• Resolves any conflicts between 
extent information in DEB and 
DSCB for each user data set. 

I • Errors detected? 

• Do any ISAM or BDAM data sets 
exist? 


IGC0W05B: Processes ISAM and 
_ BDAM data sets _ 

• For each ISAM data set open when 
the checkpoint was taken, opens 
the data set. 

■■ Errors detected? 

• Gets work space for each BDAM 
data set having an exclusive control 
list and open when the checkpoint 
was taken. 


From 

IGC0P05B, 
R05B, S05B, 
U05B 


IGC0U05B: Positions DOS tape 
_ data sets _ 

• Positions to the correct record for 
tape data sets with either a leading 
tapemark or embedded DOS 
checkpoint records. 

Errors detected?HHlHHMHH 

• Do any user data sets exist on j 

dasd?hbhmhhm 


IGC0T05B: Processes BPAM data 
sets and begins exit 

_ processing _ 

• Is DEB valid? 

• For each BPAM data set open 
when the checkpoint was taken, 
deletes directory members added 
after the checkpoint was taken. 

• Restores I/O processing suspended 
via PURGE macro at checkpoint 
time. 

• If any VSAM data sets are open, I 

call 1DA0A05B. 4 


► To VSAM 
module 
IDA0A05B 
(see VSAM 
Logic ) 
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DIAGRAM G 


From IGC0005B, 
905 B, G05B, 

G95B, H05B, 

105B, K05B, 

L05B, M05B, 

N05B, Q05B, R05B, 
S05B, T05B, 

U05B, W05B 



IGC0V05B: Exits 

• Determines whether any errors 
occurred in previous restart 
processing and issues a message 
indicating status of restart. H 

• Frees the restart work areas. 

• If security interface exists, updates 
user’s DCB. 

• If checkpoint routines opened the 
checkpoint data set, closes it. 

• Puts a return code of 4 into 
register 15, indicating restart was 
successful. 

J 

Return to 
user (SVC 3) 


Errors 

abend 
^ 13F 
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MODULE DIRECTORY 


The cross reference table that follows is ordered by CSECT name. 


Microfiche 

Name 

CSECT 

Name 

Program 

Organi¬ 

zation 

Diagram 

Method of 
Operation 
Diagram 

IGCMS66C 

IGCMSG6C 

D,E 

13, 

14 (Part 1) 

IHJACP20 

IGC0A06C 

A 

5 (Part 1) 

IHJACP25 

IGC0D06C 

A 

5 (Part 1) 

IHJQCP30 

IGCOF06C 

A 

5 (Part 2) 

IGC0G05B 

IGC0G05B 

C 

11 

IHJQCP31 

IGC0G06C 

B 

5 (Part 2) 

IGC0G95B 

IGC0G95B 

D 

11 

IGC0H05B 

IGC0H05B 

D 

12 

IHJQCP32 

IGC0H06C 

B 

5 (Part 2) 

IGC0I05B 

IGC0I05B 

D 

11 

IGC0K05B 

IGC0K05B 

D 

13 

IGC0LO5B 

IGC0L05B 

D 

13 

IGC0M05B 

IGC0M05B 

D 

14 (Part 1) 

IGC0N05B 

IGC0N05B 

E 

14 (Part 1) 

IGC0N06C 

IGC0N06C 

B 

5 (Part 3) 

6 

IGC0Q05B 

IGC0Q05B 

E 

13, 

14 (Part 1) 

IHJACP50 

IGC0Q06C 

B 

7 

IGC0R05B 

IGC0R05B 

F 

14 (Part 2) 

IGC0S05B 

IGC0S05B 

F 

13 

IHJACP70 

IGC0S06C 

B 

7 

IGC0T05B 

IGC0T05B 

F 

14 (Part 3) 

IGC0U05B 

IGC0U05B 

F 

13 

IHJARS60 

IGC0V05B 

G 

15 

IGC0W05B 

IGC0W05B 

F 

14 (Part 3) 

IHJARSOO 

IGC0005B 

C 

9 


Operation Performed 

Prints RACF message 

Builds checkpoint data set 

Builds checkpoint data set 

Builds checkpoint data set 

Builds data set entry 

Builds checkpoint data set 

Builds data set entry 

Processes dummy data sets 

Builds checkpoint data set 

Builds data set entry 

Mounts and verifies tape volumes 

Processes QSAM card reader data sets 

Mounts and verifies direct access volumes 

Processes direct access data sets 

Builds checkpoint data set 

Takes checkpoint and restores user’s I/O 
requests 

Verifies status of checkpoint data sets 
Checkpoint exit 

Positions direct access data sets 
Positions tape data sets 
Checkpoint exit 
Processes BPAM data sets 
Positions DOS tape data sets 
Restart exit 

Processes ISAM and BDAM data sets 
Restart housekeeping 
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Microfiche 

Name 

CSECT 

Name 

Program 

Organi¬ 

zation 

Diagram 

Method of 
operation 
Diagram 

IHJACPOO 

IGC0006C 

A 

3 

IHJACP01 

IGC0106C 

A 

3 

IHJARS01 

IGC0205B 

C 

9 

IHJACP02 

IGC0206C 

A 

3 

IHJQRS20 

IGC0505B 

C 

10 

IGC0506C 

IGC0506C 

A 

4 

IHJQRS21 

IGC0605B 

C 

10 

IHJQRS22 

IGC0705B 

C 

10 

IHJQRS23 

IGC0805B 

c 

10 


Operation Performed 

Checkpoint housekeeping 
Checkpoint housekeeping 
Restart housekeeping 
Checkpoint housekeeping 

Restores user’s region and task control 
information 

Purges user's I/O requests 

Restores user's region and task control 
information 

Restores user's region and task control 
information 

Restores user's region and task control 
information 
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DATA AREAS 


This section shows the work areas, records, and SVRB extended 
save area used by.checkpoint/restart. For information about 
other data areas and control blocks used by checkpoint/restart# 
see Data Areas , 


ASR (ALLOCATED STORAGE RECORD) 


An ASR is a 1024-byte record containing allocated storage record 
elements (ASREs). Each ASRE contains the starting and ending 
address of a continuous segment of allocated storage in the 
user’s region. If more than 2 ASREs are needed to describe the 
user’s region, the ASR is written in the checkpoint data set, 
followed by 1024 bytes of unused information, followed by the 
CIRs associated with each ASRE. Then another ASR is built. 

Module IGC0F06C builds the ASR and writes it in the checkpoint 
data set. 


°< ( » ASRCOUNT 

Number of ASREs in the ASR record 

2(2) ASRELti 1 
Contains X*80’ if it is 
the last ASR record 

i0) Unused 

4(4) 

Unused 


8(8) 

Starting address of first segment of storage in user’s region 

12(0 

Ending address of first segment of storage in user’s region 


Starting address of last segment of storage in user’s region 


Ending address of last segment of storage in user’s region 


I ASR 
j header 

| ASRE(l) 


ASRE(n) 
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CHECKPOINT DATA SET ENTRY 

A checkpoint data set entry is built whenever a checkpoint is 
taken. The records that comprise a checkpoint data set entry 
contain all the information necessary to restart a job. 


SS 

CHR 

Checkpoint header record 

** 


DDNTs 

DD name table 



DSDRs 

Data set descriptor records 

i S 


ASR(l) 

Allocated storage record 


5 5 

CIRs 

Core image records 

; s 

; d 

ASR(n) 

Built only if previous ASR contained more than 255 ASREs 

-w 

■ 

CIRs 


5 S 

SURs 

Supervisor records 

; s 


SSCRs 

Subsystem checkpoint records 

** 

** 

End record 

X 
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CHECKPOINT HORK AREA 


The checkpoint work area is built by module IGC0006C. 


0(0) 

CKWAOFST 

Offset from beginning of checkpoint work area to work area used 
by CHECKMA1N and CHKDCB 

4(4) 

CKBFOFST 

Offset from beginning of checkpoint work area to checkpoint buffer 

8(8) 

CKWACL 

Length of checkpoint work area 

12(0 

CKBUFL 

Length of checkpoint buffer 

16(10) 

CKTCBAD 

Address of TCB for problem program 

20(14) 

CKPPM 

Beginning address of problem program's storage 

24(18) 

CKPPE 

Ending address of problem program's storage 

28(1C) 

Unused 

32(20) 

Unused 

36(24) 

CKTIOLN 

Length of TIOT 


48(30) 

CKSSCR 

Address of first VS AM SSCR 


52(34) 

CKDECB1 

First DECB 


72(48) 

CKDECB2 

Second DECB 

5 

92(5C) 

CK1NT 

Unused 


96(60) 

CKSYNAD 

Save area for SYNAD address in user's DCB 


100(64) 

CKPARMAD 

Address of PARMLST, a parameter list containing information 
the user specified in the CHKPT macro 

104(68) 

CHUNIT 

Unit checkpoint data set is on 

107(6B) 

£ 

CKDDNAME 



ddname for checkpoint data set 

115(73) 


CKVOLSER 

Volume serial number for checkpoint data sei 

1 


42{2A) CKDCBSI 

Block size user specified for checkpoint data set 

46 (2E) CKMSGCOD 

Message code 


40(28) CKFLAG1 I 41<29) CKILAG2 2 

44(2C) CKRETCOD 

Return code 
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124{7C) 




CKCHEK1D 



System-generated checkid 


132(84) 

CKTTR 



TTR for BPAM checkpoint data set 


136(88) 

CKJCTMB 



MBBCCHHR of JCT 


144(90) 




CKERAS00-09 



Work area 


184(B8) 



T 

CKREGSAV 

Register save area 

A 

256(100) 




JCT 



Job control table 


432(1 BO) 




ECB, 10B, CCWs 


r 

Control blocks and channel program for reading JCT 


504 (1 i‘‘B) 




Variable-length scratch area 

A/ 

Size of area depends on number of user data sets open when the CHKPT macro was issued 



Checkpoint buffer 


^ The CHR, SURs, and SSCRs arc built in this buffer. The CHR buffer is 400 bytes long. 


T The SUR buffer, which is 200 bytes long, overlays the first 200 bytes of the CHR buffer. 



The SSCRs are 4096 bytes long. 



1 X‘Or~checkpoint data set is using BPAM 
X‘02’-checkpoint modules opened checkpoint data set 

X‘04’-user requested cancellation of automatic restart (via CANCEL parameter in CHKPT macro) 
X*20’-checkpoint data set is on tape 
X‘40’-track overflow was specified 
X*80’-task is in real storage (V=R) 

2 X'Ol'-l/O has been purged 

X*02*-checkpoint work area should be freed 
XW’-user supplied a checkid 
X‘20*-EOV occurred 
X‘80*-CHR was written 
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CHR (CHECKPOINT HEADER RECORD) 

The CHR is a 400-byte record, built by module I6C0206C and 
uiritten in the checkpoint data set by module IGC0A06C. One CHR 
is built in each checkpoint entry. 


0(0) CHRCOUNT 

Number of checkpoints taken, 
including this one 

2(2) CHROKIDL 

Length of checkid 

4(4) 




* 

CHECK ID 

Name of checkpoint data set entry 

s 

20(14) 





C'llRDDNM 

ddname of checkpoint data set 


28(10 

CHRPPM 

Size of region 


32(20) 

CHRPPI. 

Size, in bytes, of problem program's storage 


36(24) C'HRBLKS! 

Block size of checkpoint data set 

38(26) CHRTIOTL 

Length ol'TIOT 

40(28) CHRFLAGS 
Checkpoint 
flag byte 1 1 

41 < 29 > OHRWALL 

Size of checkpoint work area 

44(20 CHRFLAG2 
Checkpoint 
flag byte 2 2 

45 < 2I) > C'HRWAAD 

Address of checkpoint work area 

48(30) 

CHRSVRB 

Address ofSVRB used by checkpoint routines 


52(34) 

CHRPPM L 

Unused 


56(38) 

CHRPPIL 

Unused 


60(30 CIIRSYSII) 
CVTIX’B 

Ik-lil 

61(31)) 




CHR1D 

C’$S/%@/$ CHR %@/$//%’ (19 bytes) 



1 X‘0r-BPAM checkpoint data set 

X‘02’-a checkpoint routine opened the data set 
X‘40*-track overflow specified 
X‘lO*-user authorized to issue MODESET macro 
X‘04’-automatic restart canceled 
X‘08’-real storage specified for the task 
X l 20*-tape checkpoint data set 

2 X l 04’-user supplied checkid 
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CIR [CORE IMAGE RECORD! 


A CIR is a 2048-byte record that contains a copy of one 
continuous segment of allocated storage in the user’s region. 

The boundaries of a continuous segment of storage are described 
by an ASRE in the ASR. One CIR is built for each ASRE unless a 
continuous segment of storage is larger than 2048 bytes; in that 
case, as many CIRs as are needed to copy it will be built. 

CIRs are written in the checkpoint data set by module IGC0F06C. 
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DATA SET ENTRY 


The data set entry, which is embedded in the restart work area, 
is used for restoring and positioning user data sets. One data 
set entry is built for each use' data set open when the CHKPT 
macro was issued. 


° (0) TABDSORG 1 

HD i'ABDCBAD 

Address of DCB for this data set 

4(4) tabilc.i 2 

5(5) TABSEGAD 

Address of buffer into which the JI ; CB is read for this data set 

8(8) TABNVOLS 

9(9) TABJFCB 

TTR address of JFCB for this data set 

12(C) TABOTIOT (DASD) or 

TABTPLBL and TABISQNO <tapc) J 

14(K) TABFLG2 4 I5<F) TABFLG3 5 

I6( 10) TABFLG4 6 

! 7(! 11 TABFLG 5 7 

18(12) 

TABVL1D1 through TABVLID5 

l ive 6-byte fields for the volume identification numbers for this data set. One field 5 

is used for the volume identification number of each volume containing the data set. 


1 TABDSORG contains one of the following codes indicating what was specified in the DSORG 
parameter in the DCB: 


X‘80’-IS 

X‘40’-PS 

X‘20’-DA 

X‘02’-PO 

X‘01’-U 

2 TABFLG1 contains one of the following codes: 

X*80’-NULLFILE or SYSCHECK DD (subsystem data set) statement submitted 

X 4 40’-SYSIN or SYSOUT data set 

X 4 20*-data set on DASD 

X‘10*-data set on tape device 

X*08*-last data set entry 

X 4 04 4 -unit record or other (not DA or tape) 

X‘02‘-TCAM data set 

X‘01*-DOS tape with embedded DOS checkpoint records 

3 If the data set is on a DASD, the 2-byte TABOTIOT field contains the offset from the beginning of the old 
TIOT to the ddname in that TIOT. 

If the data set is on tape, the 2-byte TABI'SQNO field (X*0D’) contains the file sequence number and the 
2-byte TABTPLBL field (X 4 0C) contains one of the following codes describing tape label status: 

X 4 80*-error detected during execution of NSL routine 

X 4 40 4 -nonstandard label mount switch 

X‘20’-nonstandard label communication bit 

X 4 10’-bypass label processing 

X‘08’-ASC1I label 

X‘04’-nonstandard label 

X‘02’-standard label 

X'Ol’-no label 

4 TABFLG2 contains one of the following codes: 

X 4 80’-data set on more than 5 volumes 
X‘40’-BPAM data set is concatenated 

X‘20 4 -process control switch (password, partial release, ISAM open, DOS tape processing) 

X 4 10’-checkpoint data set being used for restart 
X 4 08'-ISAM/VSAM (compatibility interface) data set 
X‘04*-VIO data set 

X 4 02*-old data set was a subsystem data set 

5 TABFLG3 contains one of the following codes: 

X 4 80’-checkpoint data set at checkpoint time 
X‘40’-checkpoint data set at restart time 

6 TABFLG4 contains one of the following codes: 

X‘80’-Bypass password checking because of RACE authorization 
X‘40’-RACF authorized for input 
X‘20’-RACF authorized for output 

7 TABFLG5 may contain one of the following: 

For tape data sets, logical file sequence number. 

For DASD: X 4 0r~DA label (DSCB) checking completed 

X‘02*-DA multivolume switch for DSCB extent checking 
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DPNT (PD NAME TABLE) 



0(0) DDNT1DNT 2(2) DDNTUSCT 

Contains X-Q001 \ the DDNT identification ^'ateDDNTDDNM)in thfs'fabfe 6 "' 0 


4,4) DDNTLINK 

SWA address of next DDNT 


8 ( 8 ) 

DDNTDDNM 

* Might-by to ddnUnic of each data set that has been dynamically deallocated since 

the beginning of the job step. Up to 21 of these entries may exist. 
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PSDR (DATA SET DESCRIPTOR RECORD) 

A DSDR is a record in the checkpoint data set containing one of 

the following types of information* 

• Type 1 DSDR—contains the JFCB for each data set open when 
the CHKPT macro was issued. 

• Type 2 DSDR—contains the JFCB extension* if one exists* for 
each user data set open when the CHKPT macro was issued. 

• Type 3 DSDR—contains the GDG bias-count table* if one 
exists* for each user data set open when the CHKPT macro was 
issued. 

• Type 4 DSDR—contains the SIOT for each dynamically 
allocated data sets. 

The physical size of the DSDR record in the checkpoint data set 

is 400 bytes (2 DSDRs are written as one physical record). 

DSDRs are built and written in the checkpoint data set by module 

IGC0D06C. 


Type 1 DSDR 



X‘0000’ 



i 

JFCB 

(176 bytes) 


i 

ddname of data set 
(8 bytes) 

* 


UCBTYP field from UCB 
(4 bytes) 



SCTDISP, SCTSBYT3, SIOTALTD, and SIOTFP fields from SIOT 



DEBVLSEQ field 
(1 byte) 


Type 2 DSDR 


X‘0004* 



s 


JFCB extension 
(176 bytes) 

* 



Type 4 DSDR 


X'OOOC* 



i 


Dynamically allocated SIOT 
(187 bytes) 
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END RECORD 


The end record (4096 bytes) is the last record written in a 
checkpoint entry. It is formatted and written by IGC0N06C. 
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REPMAIN I40RK AREA 

The REPMAIN work area is embedded in the restart work area. It 
is used by restart modules IGC0505B, IGC0605B, IGC0805B, and 
IGC0905B. 


0(0) 

ERAS1 

Temporary save area 


4(4) 

Unused 


8(8) 

RSBFSTAD 

Address of block being processed in SUR buffer 


12(C) 

RSBFLWA 

Used to calculate number of bytes remaining in SUR buffer 


16(10) 

RPMMSSl 

Address of first SPQE in restored SPQE chain for system task 


20(14) 

RPMMSS2 

Address of first SPQE in restored SPQE chain for initiator task 


24(18) 

RPMMSS3 

Address of first SPQE in restored SPQE chain for problem program task 


28(1C) 

RPMRB 

Address of first RB in RB chain 


32(20) 

RPMLLE 

Address of first LLE in LLE chain 


36(24) 

RPMCDE 

Address of first CDE in CDE chain 


40(28) 

RPMDEB 

Address of first DEB in DEB chain 


44(20 

RPMFOE 

Address of first FOE in FOE chain 


48(30) 

RSCORE 

Beginning address of storage acquired when last GETMA1N macro was issued 


52(34) 

Module-dependent 


56(38) 

Module-dependent 


60(3C) 

RPLNT 

Length of the block 


64(40) 

Unused 


68(44) 

Unused 


72(48) 



i i 

CKSAVAR 

Register save area 

T 
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136(88) 

* s 

RPMN40 

Module Name for XCTL 

ft 

144(90) 

RP40XCTL 

Pointer to XCTL parameter list 


148(94) 

RSSWITl 

Big block switch 


152(98) 

RSTCBSAV 

Address of checkpointed TCB 


156(9C) 

RSAPPLNT 

Length of SUR appendage 


160(A0) 

RMCDSAV 

Save cell for LPA CDE search 
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RESTART WORK AREA 

The restart work area is built by module IGC0005B. Following is 
the format of the part of the restart work area used to restore 
the user's region and system control information and the format 
of the part of the restart work area used to restore and 
position the user's data sets. 


FOR RESTORING USER'S REGION AND SYSTEM CONTROL INFORMATION 



28(10 


40(28) 


44(20 


52(34) 


56(38) 


60(30 


64(40) 


RSWAOIST 

Offset from beginning of restart work area to REPDOB work area 


RSMWOIST 

Offset from beginning of restart work area to REPMAIN work area 


RSBI OI ST 

Offset from beginning of restart work area to SUR buffer 


RSCKDCB 

Address of DCB for cheekpoint data set 


RSWACL 

Length of restart work area 


RSBU1L 

Length of SUR buffer 


RSDCBELG or RSDCBL 
Length of RLPDCB work area 


RS1NT 

Address of DEB chain 


RSTCBAD 

Address of restart’s TCB 


RSPPM 

Beginning address of problem program’s storage 


RSPPE 

Ending address of problem program’s storage 


Unused 


RST10T0 

Length of T10T used when checkpoint was taken 


RST10TAD 

Address of HOT used when checkpoint was taken 


RSC1RTTR 

TTR of first C1R in checkpoint data set 


RSSVRBN 

Address of SVRB used by restart routines 


68(44) I 69(45) 2 70(46) RSDCBSI 

RSE LAO 1 RSrLAG- Block size user specified for checkpoint data set 


72(48) RSRETCOD 

Return code 


76 (4C) 


84(54) 


DCCVP R 

Address ofCHKPT SVRB 


RSNSTAE 

Address of first SCB in user’s SCB chain 


RSP1E 

Address of first PIE in user’s PIE chain 


RSSSCR 

Address of first VSAM SSCR 
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92(50 

RSBDCB 

DCB for checkpoint data set 


1 180<B4) 1 

* 

RSDECB1 



first DECB 


200(C8) 



2 

RS10BCP 

Storage area for IOB and channel program 


1320(140) 


RSERAS00-09 



Work area 


1360(168) | 


RSREGSAV 



Register save area 


1432(IB0) | 


RST10TL 

Length of TIOT save area 


|440(1B8) 1 


RST10T 



TIOT save area 


s 

REPMAIN work area 

5 

* 

SUR and SSCR buffer (4096 bytes) 

? 


1 X*01 ‘-checkpoint data set is using BPAM 
X*02'-checkpoint modules opened checkpoint data set 
X‘20'-checkpoint data set is on tape 

2 X‘04*-a TCAM DEB exists for this job 

X *08'-user didn't specify block size for checkpoint data set 
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FOR RESTORING AND POSITIONING USER'S DATA SETS 


0 ( 0 ) 


Common portion of restart work area 


440(1 B8) 


RSTIOT 

Variable-length save area for TIOT table 


TABL (data set entries) 

Variable number of 48-byte data set entries. Restart routines build 
one entry for each user data set open when the CHKPT macro was issued. 


JFCB buffer 

Variable number of 304-byte segments addressed from the TABSEGAD 
field of the data set entry (TABL field) for each user data set open at 
checkpoint time. The JFCB for each data set is read into one of these 
segments. The segments are set up in IGC0G05B and used in IGC0G95B,, 
IGC0I05B, IGC0K05B, and IGC0M05B. 


Tape repositioning buffers 

Variable number of 208-byte segments addressed from the TABSEGAD 
field of the tape data set entry (TABL field) for each tape data set open 
at checkpoint time. Each segment contains control blocks (DEB, DCB, 
ECB, IOB), channel program, status bytes, and space for reading in header 
labels for repositioning user tape data sets. Segments are formatted in 
IGC0P05B and used in IGC0S05B and IGC0U05B. 


SSCR fSUBSYSTEM CHECKPOINT RECORD) 

SSCRs are 4096-byte records written in the checkpoint data set 
if VSAM, SPIE, or subsystem data sets are open when the 
checkpoint is taken, 

SSCRs contain information used at restart time to restore 
control blocks to storage and to resposition data sets. VSAM 
and subsystem SSCRs are formatted and written in IGCON06C; SPIE 
SSCRs are formatted and written in IGC0H06C. 


0(0) SSCRID 
X"01’=SP1E record ID 

1(I) sscrssid‘ 

2(2) SSCRHDRL 

Header length and offset to data area 

4(4) 

SSCRFCHN 

Pointer to other SSCRs, if any exist 

1 

8<8) SSCRFLG 2 

9(9) SSORES1 
Reserved 

10(A) SSCRDATL 

Length of data 

12(C) 

SSCRDCBA 

Address of associated DCB 


16(10) 




5 t 

SSCRDATA 

Subsystem data 

S j 


1 X*00*-subsystem interface data set 
X’Ol’-VSAM data set 
X‘02*-SPIE data set 

2 1.-checkpoint time 

0.-restart time 

. xxx xxxx-reserved 
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SUR (SUPERVISOR RECORD) 


A SUR is a 400-byte record containing the information outside 
the user’s region that is necessary to restart a job. Control 
blocks and other pieces of control information are stored 
sequentially in the SUR with a code that identifies the type of 
information preceding each. A complete control block or piece 
of control information is stored within one SUR record; it never 
overlaps the next SUR record. 

SURs are built and written in the checkpoint data set by modules 
IGC0G06C and IGC0H06C. The codes that precede and identify each 
type of information in a SUR follow* 


Code 
(in hex) 

Control Block or Other Piece of 
Information That Identification 

Control 

Code Precedes 

02 

FQE 


04 

DSAB fields (44 - last DSAB, 24 
private catalog data sets) 

- DSAB for VSAM 

05 

PRB that was created when SYNCH 

macro uias issued 

06 

SPQE 


07 

DQE 


08 

FOE 


09 

CDE 


0A 

LIE with CDE on job pack queue 


0B 

PRB with CDE on job pack queue 


OC 

PRB with CDE on link pack area queue 

0D 

TCBNSTAE field in TCB 


0E 

LLE with CDE on link pack area queue 

OF 

TCBUSER field in TCB 


OF 

TCBCAUF field in TCB 


OF 

TCBFSA field in TCB 


OF 

CKDCBAD field in DCB 


OF 

CKSYNAD field in DCB 


OF 

CKDCBSI field in DCB 


10 

General registers 0-15 


11 

SCB 


12 

IRB 


13 

Floating point registers 


14 

TIOT 


15 

CKTCBAD field in checkpoint work 

area 

15 

TCBPIE field in TCB 


16 

TCB 


17 

Extent list 


18 

TCB extension 
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10 

SVRB 

created when the SVC for EOV was issued 

IE 

Type 

4 (not first load) SVRB 

IF 

Type 

2, 3, or 4 (first load) SVRB 

20 

DEB 

extension 

21 

PIRL 

(purge I/O restore list) 

22 

EPCB 

(first) 

23 

EPCB 

(subsequent) 

30 

PSA 


31 

CVT 

- Part 1 

32 

CVT 

- Part 2 

33 

CVT 

- Part 3 

34 

CVT 

Extension 2 

35 

PVT 

- Part 1 

36 

PVT 

- Part 2 

37 

PVT 

- Part 3 

38 

PVT 

- Part 4 

39 

PVT 

- Part 5 

3A 

SCVT 


3B 

SVC 

table - Part 1 

3C 

SVC 

table - Part 2 

3D 

SVC 

table - Part 3 

80 

Non- 

ISAM DEB 

81 

ISAM 

DEB 

82 

Dummy DEB 

83 

Subsystem DEB 


72 Checkpoint/Restart SVC Logic 


LY26-3916-1 © Copyright IBM Corp 


1972, 1985 



Restricted Haterials of XBH 
Licensed Materials - Property of IBM 

SVRB EXTENDED SAVE AREAS 


SVRB EXTENDED SAVE AREA USED BY MODULE XGC0006C 


0 ( 0 ) 


HKPSVRB 
Fixed area in SVRB 


96<60 > Unused 

9*7(61) HKPRETCD 

98(62) HKPMSGCD 

Return code 

Message code 

100(64) 

HKPGML 



Parameter list for GETMAIN macro 


104(68) 


HKPGMLAD 

Length and address of space obtained by GETMAiN macro 
for checkpoint work area 


112(70) HKPGL1ST 

Parameter list for OPEN, GETMAIN, and XCTL macros 


116(74) HKPWD2 

Character to alter module name to name of next module to get control 


120(78) HKPNTLST 

Address of the area that contains the address of a parameter list 


124(70 HKPTIOTL 

Length of TIOT 

126( 7E ) ,, . 

Unused 

128(80) HKPFLAG 1 

Flag byte 

129(81) HKPTIOAD 

Address of TIOT 

132 ( 

— 

133(85) HKPDCBAD 

Address of DCB for checkpoint data set 


136(88) Unused 


1 X‘0r-error has occurred;give control to IGC0Q06C 
X‘02‘-checkpoint data set is open 

X‘04*-user requested cancellation of automatic restart (via CANCEL parameter in CHKPT macro) 
X*10’-checkpoint routines should close checkpoint data set 
X‘20*-environmental error detected 
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SVRB EXTENDED SAVE AREA USED BY MODULE XGC0Q06C 


0 ( 0 ) 


CERSVRB 
Fixed area in SVRB 


* 


96(60) 


CERRETCD 
Return code 


98(62) 


CERMSGCD 
Message code 


100(64) 


CERMSGMD 

Name of next module to get control 


108(6C) 


CERXCTL 

Address of next module to get control 


112(70) 


CERJOBNM (or CERCHKID) 
Job name (or checkid) 


120(78) 


CERDDNM 

ddname for checkpoint data set 


128(80) 

CERTIOAD 


Address of TIOT 

132(84) 

CERDCBAD 

Address of DCB for checkpoint data set 
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DIAGNOSTIC AIDS 


MESSAGES ISSUED BY CHECKPOINT/RESTART 

Checkpoint/restart modules issue the following messages* 

• IHJ000I CHKPT iii l (ddn)3 NOT TAKEN C xxx ) 

• IHJ001I ii 5 ( ddn,utn> ser ) INVLD checkid ( xxx ) 

• IHJ002I iii ( ddn,utn, ser ) ERROR checkid ( xxx ) 

• IHJ004I iii ( ddn,utn, ser ) CHCKPT checkid 

• IHJ005I Hi ( ddn>utn,ser ) ENQS checkid ( xxx ) 

• IHJ007I RESTART NOT SUCCESSFUL FOR Hi ( xxx [,utnl ) 

• IHJ008I Hi RESTARTED 

• IHJ009I ERROR ON ddname 

• IHJ101I USER NOT AUTHORIZED TO DASD DATA SET = dsname, ser 

• IHJ102I ENVIRONMENT NOT RACF AUTHORIZED TO TAPE VOL = ser 
where* 

checkid 

is the identification assigned to a checkpoint entry. 

ddn 

is the ddname of the checkpoint data set. 

iii 

is the job name. 

ser 

is the volume serial number of the checkpoint data set 
volume. 

utn 

is the unit number. 

xxx 

is the message code as described below. 
ddname 

is the ddname of the data set that caused the error. 


sss 

is the step name. 

Following is a list of these messages; the message and return 
codes associated with them, and the module detecting each error. 
All messages resulting from errors detected during checkpoint 
processing are issued by IGC0S06C. Messages resulting from 
errors detected during restart processing are issued by 
IGC0V05B. For a description of modules IDA0A05B, IDA0C05B, 
IDAOC06C, and IDA0I96C, see VSAM Logic . 
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Message 

Number 

Reason 

Code 

Return 
Code 
(in hex) 

Module 

Detecting 

Error 

Meaning of Message Code 

IHJ000I 

001 

08 

IGC0006C 

Error in parameters of CHKPT macro. 


001 

08 

IGC0506C 

Error in parameters of CHKPT macro. 


002 

OC 

IGC0006C 

Error opening DCB for checkpoint data 
set. 


003 

08 

IGC0006C 

GETMAIN for checkpoint work area failed. 


003 

08 

IDA0C06C 

GETMAIN for checkpoint work area failed. 


005 

08 

IGC0106C 

KEYLEN for checkpoint data set not 0. 


006 

08 

IGC0106C 

RECFM for checkpoint data set not U. 


007 

08 

IGC0006C 

DSORG for checkpoint data set not PO or 
PS. 


007 

08 

IGC0106C 

DSORG for checkpoint data set not PO or 
PS. 


008 

08 

IGC0106C 

Time interval specified in STIMER macro 
hasn't elapsed. 


009 

08 

IGC0106C 

Checkpoint macro issued in exit routine 
other than E0V or an RB of an 
unacceptable type was found on the RB 
chain. 


010 

08 

IGC0106C 

Graphics data set open when CHKPT macro 
issued. 


011 

08 

IGC0006C 

Current task is a subtask. 


012 

08 

IGC0006C 

Current task has subtasks. 


013 

08 

IGC0106C 

Checkpoint issued with an outstanding 

PCLINK. 


014 

08 

IGC0106C 

No reply received for an outstanding 

WTOR. 


015 

08 

IGC0106C 

Checkid provided by caller was invalid. 


016 

08 

IGC0006C 

Checkpoint data set not on DASD or tape. 


016 

08 

IGC0106C 

Checkpoint data set not on DASD or tape. 


019 

08 

IGC0106C 

Checkpoint data set not opened for 
output. 


021 

08 

IGC0106C 

Label for checkpoint data set specified 
as AL or AUL. 


025 

OC 

IGC0206C 

Error when JCT read. 


027 

08 

IGC0A06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 


029 

08 

IGC0106C 

American National Standards Institute 
(ANSI) translation for tape specified 
(0PTCD=Q in DCB). 


030 

OC 

IGC0506C 

I/O error during PURGE operation. 
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Message 

Number 


Reason 

Code 

Return 

Code 

Cin hex) 

Module 

Detecting 

Error 

Meaning of Message Code 

032 

oc 

IHJACP01 

ISAM data set is open with DISP=SHR. 

041 

08 

IDA0C06C 

The checkpoint was issued with (1) VSAM 
key sequenced data set open for create 
mode processing, (2) VSAM entry 
sequenced data set open for create mode 
processing with no repositioning 
(AMP=CROPS=NRE) specified, or (3) VSAM 
entry sequenced data set open for 
noncreate mode processing with active 
requests outstanding. 

042 

OC 

IDA0C06C 

VSAM checkpoint repositioning error. 

043 

08 

IDA0C06C 

Repositioning specified for ESDS with a 
path open for immediate upgrade. 

044 

08 

IDA0C06C 

Direct processing performed against an 
RRDS in create mode. 

045 

08 

IDAOC06C 

Global shared resources specified. 

102 

08 

IGC0106C 

A checkpoint was requested when a DCB 
was open for a data set in support of 
Version 3 ISO/ANSI (International 
Organization for 

Standardization/American National 
Standards Institute) tape labels. 

134 

08 

IDAOC06C 

No storage available for VSAM open or 
close. 

121 

OC 

IGC0506C 

SYNCDEV error has been detected. 

146 

OC 

IDA0C06C 

1/0 error completing I/O request. 

147 

08 

IDA0C06C 

ACB is not for a valid data set. 

200 

OC 

IGC0506C 

Uncorrectable error during PURGE 
operation. 

202 

0C 

IGC0006C 

Uncorrectable error during SETIOCK 
operation. 

202 

OC 

IGC0506C 

Uncorrectable error during SETLOCK 
operation. 

206 

08 

IGC0106C 

VTAM data set open when CHKPT macro 
issued. 

208 

08 

IGC0006C 

New checkpoint data set is not empty. 

209 

08 

IGC0006C 

More than one DCB specifying the 
checkpoint data set open. 

210 

08 

IGC0006C 

DISP=SHR coded for checkpoint data set. 

211 

08 

IGC0006C 

Volume specified for creation of new 
checkpoint data set not secure. 

212 

08 

IGC0006C 

Tape checkpoint data set didn’t have 
standard labels. 

213 

08 

IGC0006C 

Checkpoint data set was subsystem data 


set. 
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Message 

Number 


IHJ001I 


Reason 

Code 

Return 

Code 

(in hex) 

Nodule 

Detecting 

Error 

Meaning of Message Code 

214 

08 

IGC0006C 

New checkpoint data set on a shared 
direct access device. 

224 

08 

IGC0106C 

SAM subsystem interface data set (not 
using the compatibility interface) open 
when CHKPT macro issued. 

240 

OC 

IDA0C06C 

ESTAE macro failed. Recovery 
environment could not be established. 

241 

OC 

IDA0C06C 

Uncorrectable error occurred. 

242 

OC 

IDA0C06C 

Machine check occurred. 

250 

08 

IGC0106C 

IMAGELIB DCB open. 

003 

08 

IDA0I96C 

No storage available for VSAM 
checkpoint. 

017 

08 

IGC0Q06C 

No directory space for BPAM checkpoint 
data set. 

022 

OC 

IGC0D06C 

Error reading control blocks from SWA. 

023 

OC 

IGC0A06C 

I/O error writing checkpoint data set. 

023 

0C 

IGC0D06C 

I/O error writing checkpoint data set. 

023 

OC 

IGC0F06C 

I/O error writing checkpoint data set. 

023 

OC 

IGC0G06C 

I/O error writing checkpoint data set. 

023 

OC 

IGCOH06C 

I/O error writing checkpoint data set. 

023 

OC 

IGC0N06C 

I/O error writing checkpoint data set. 

026 

OC 

IGC0Q06C 

I/O error during STOW operation. 

027 

08 

IGC0A06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 

027 

08 

IGC0D06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 

027 

08 

IGC0F06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 

027 

08 

IGC0G06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 

027 

08 

IGC0H06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 

027 

08 

IGC0N06C 

EOV (second time on tape, first on DASD) 
when writing checkpoint entry. 

207 

OC 

IGC0N06C 

Subsystem interface failed. 

240 

OC 

IDA0I96C 

Recovery environment could not be 
established during a checkpoint of VSAM 
data sets. 

241 

OC 

IDA0I96C 

Indeterminate error occurred during a 


checkpoint of VSAM data sets. 
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Return Module 

Message Reason Code Detecting 


Number 

Code 

(in hex) 

Error 

Meaning of Message Code 


242 

oc 

IDA0I96C 

A machine check occurred during a 
checkpoint or restart of VSAM data sets. 

IHJ002I 

025 

oc 

IGCOQ06C 

Error when JCT written to SWA. 


204 

oc 

IGC0Q06C 

WIJOURN macro issued for VIO data set 
unsuccessful; current checkpoint 
unavailable for automatic restart. 


205 

oc 

IGC0Q06C 

WIJOURN macro issued for VIO data set 
unsuccessful; all checkpoints for step 
unavailable for automatic restart. 


215 

18 

IGCON06C 

Uncorrectable error during RESTORE 
operation. 

IHJ004I 

None 

None 

Not ap- 
plicable 

Checkpoint taken successfully. 

IHJ005I 

000 

10 

IGC0106C 

Resources had been enqueued when 
checkpoint was taken (probable error). 


017 

08 

IGC0106C 

Insufficient storage to check for ENQs. 


018 

08 

IGC0106C 

GQSCAN macro discovered an abnormal 
condition. 

IHJ007I 

002 

None 

IGC0005B 

Status (virtual or real storage) of 
checkpoint and restart tasks differs. 


004 

None 

IGC0005B 

Environment of checkpoint and restart 
tasks differs. 


023 

None 

IGC0005B 

Error when reading control blocks from 
SWA. 


024 

None 

IGC0G95B 

Error when reading control blocks from 
SWA. 


025 

None 

IGC0I05B 

Error when reading control blocks from 
SWA. 


026 

None 

IGC0K05B 

Error when reading control blocks from 
SWA. 


027 

None 

IGC0N05B 

Error when reading control blocks from 
SWA. 


030 

None 

IGC0K05B 

Error during execution of user's NSL 
routine. 


031 

None 

D5DRP 

A DD statement was DUMMY in the original 
run and is not DUMMY in the restart run. 


032 

None 

IGC0705B 

DD statement missing for restarted step. 


033 

None 

IGC0G05B 

DD statement missing for restarted step. 


034 

None 

DSDRP 

DD statement missing for restarted step. 


035 

None 

IGC0505B 

I/O error when reading checkpoint data 
set. 


036 

None 

IGC0605B 

I/O error when reading checkpoint data 
set. 
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Message 

Number 


Reason 

Code 

Return 
Code 
(in hex) 

Module 

Detecting 

Error 

Meaning of Message Code 

037 

None 

IGC0705B 

I/O error when reading checkpoint data 
set. 

0 38 

None 

DSDRP 

I/O error when reading checkpoint data 
set. 

039 

None 

IGC0N05B 

I/O error when reading checkpoint data 
set. 

040 

None 

IGC0K05B 

I/O error when reading standard volume 
label. 

041 

None 

IGC0505B 

Wrong length record detected when 
reading checkpoint data set. 

042 

None 

IGC0605B 

Wrong length record detected when 
reading checkpoint data set. 

043 

None 

IGC0705B 

Wrong length record detected when 
reading checkpoint data set. 

044 

None 

IGC0K05B 

UCB not available. 

045 

None 

IGC0M05B 

UCB not available. 

046 

None 

IGC0K05B 

No secondary control unit for 1275/1419. 

048 

None 

IGC0M05B 

I/O error when reading volume label in 
direct access device. 

049 

None 

IGC0M05B 

MSS failure. See message IEC4661 for 
explanation and reason code. 

050 

None 

IGC0M05B 

Volume serial at restart not equal to 
volume serial at checkpoint. 

052 

None 

IGC0605B 

Module in LPA at checkpoint time either 
not there now or its location has 
changed. 

053 

None 

IGC0605B 

Module in LPA at checkpoint time has 
different entry point address for 
restart. 

060 

None 

IGC0S05B 

Error in repositioning tape data sets. 

063 

None 

IGC0S05B 

Error when positioning tape data set. 

064 

None 

IGC0U05B 

Error when positioning tape data set. 

065 

None 

IGCOU05B 

Error positioning tape to correct data 
set. 

072 

None 

IGC0R05B 

I/O error when reading DSCB or the data 
set was scratched or deleted. 

073 

None 

IGC0N05B 

I/O error when reading DSCB or the data 
set was scratched or deleted. 

074 

None 

IGC0W05B 

I/O error when reading DSCB or the data 
set was scratched or deleted. 

076 

None 

IGC0R05B 

Number of extents in DEB and DSCB for 


input data set not equal. 
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Message 

Number 

Reason 

Code 

Return 
Code 
(in hex) 

Module 

Detecting 

Error 

Meaning of Message Code 


077 

None 

IGC0WG5B 

Error during ISAM open. 


079 

None 

IGC0H05B 

Non-BSAM or -QSAM data set made dummy at 
restart time. 


080 

None 

IGC0H05B 

Cl DEB made dummy at restart time. 


082 

None 

IGC0G95B 

TCAM control program not active at 
restart time. 


083 

None 

IGCOJ05B 

QNAME parameter process entry not in 
terminal table. 


084 

None 

IGC0J05B 

QNAME parameter process entry being used 
by another user. 


085 

None 

IGC0J05B 

GETMAIN for TCAM control blocks failed. 


092 

None 

IGC0T05B 

I/O error when processing BPAM 
directory. 


095 

None 

IGC0G06C 

A control block chaining error occurred. 


096 

None 

IGC0T05B 

Error during STOW operation. 


099 

None 

IGC0G05B 

Missing DSAB at restart. 


132 

None 

IDA0A05B 

ddname not found in TIOT. 


133 

None 

IDA0A05B 

Error reading or writing JFCB. 


134 

None 

IDA0A05B 

No storage available. 


136 

None 

IDA0A05B 

I/O error reading or writing catalog 
entry. 


137 

None 

IDA0A05B 

Catalog entry not found. 


138 

None 

IDA0A05B 

Password was invalid. 


140 

None 

IDA0A05B 

Conflicting parameters. 


141 

None 

IDAOA05B 

I/O error reading volume label. 


142 

None 

IDA0A05B 

Data set not available. 


144 

None 

IDA0A05B 

PGFIX failure. 


145 

None 

IDA0A05B 

Catalog does not exist or is not open. 


146 

None 

IDA0A05B 

I/O error completing I/O request. 


147 

None 

IDAOA05B 

ACB is not for a valid data set. 


148 

None 

IDA0A05B 

Unusable data set open for output. 


149 

None 

IDA0A05B 

Access to data set via empty path AIX. 


150 

None 

IDA0A05B 

Format-4 DSCB indicates volume is 
unusable. 


153 

None 

IDA0A05B 

ACB indicates LSR and data set is empty. 
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Reason 

Code 

Return 
code 
(in hex) 

Nodule 

Detecting 

Error 

Meaning of Message Code 

154 

None 

IDA0A05B 

ACB indicates LSR and key of data set 
exceeded maximum key length in BLDVRP 
macro. 

155 

None 

IDA0A05B 

Shared resources—BSPH too small. 

157 

None 

IDAOA05B 

Shared resources VSRT does not exist. 

158 

None 

IDA0A05B 

Reset specified for nonreusable data 
set. 

159 

None 

IDA0A05B 

An MSS acquire/relinquish error 
occurred. 

160 

None 

IDA0A05B 

Volume time stamp discrepancy for output 
ACB. 

161 

None 

IDA0A05B 

CRA volume not mounted. 

174 

None 

IDA0A05B 

ACB is not for a valid data set. 

181 

None 

IDA0A05B 

VSAM restart preformat error. 

182 

None 

IDA0A05B 

VSAM restart verify error. 

183 

None 

IDA0A05B 

VSAM restart put error. 

184 

None 

IDA0A05B 

VSAM restart index put error. 

190 

None 

IDA0A05B 

Error from catalog interface routine. 

191 

None 

IDA0A05B 

Error from volume mount routine. 

193 

None 

IDA0A05B 

Data set was in create mode during 
checkpoint but not during restart. 

194 

None 

IDA0A05B 

Immediate upgrade AIX added or deleted 
since checkpoint. 

195 

None 

IDA0A05B 

No storage available for VSAM restart. 


None 

IDA0C05B 

No storage available for VSAM restart. 

196 

None 

IDA0A05B 

The catalog for the cluster has been 
updated after the checkpoint was taken. 

198 

None 

IDA0A05B 

The cluster has extended to a new volume 
after the checkpoint was taken. 

199 

None 

IDA0A05B 

An error occurred during BLDVRP 
processing. 

201 

None 

IGC06Q5B 

Uncorrectable error during PGFIX 
operation. 

202 

None 

IGC0505B 

IGC0605B 

Uncorrectable error during SETLOCK 
operation. 

202 

None 

IGC0805B 

Uncorrectable error during SETLOCK 
operation. 

202 

None 

IGC0905B 

Uncorrectable error during SETLOCK 
operation. 

203 

None 

IGC0005B 

User attempted to invoke IEFRSTRT. 
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Message 

Number 

Reason 

Code 

Return 
Code 
(in hex) 

Module 

Detecting 

Error 

Meaning of Message code 


207 

None 

IGC0N05B 

Table for subsystem data set not found 


208 

None 

IGC0N05B 

Bad return code from subsystem. 


216 

None 

IGC0005B 

Reallocation of user’s region 
unsuccessful. 


217 

None 

IGC0905B 

Error during FINDPAGE operation. 


218 

None 

IGC0Q05B 

In a situation in which more than one 


data set was being used to take 
checkpoints* one of the data sets (not 
the one used for restart) was deemed 
insecure. 


219 

None 

IGC0S05B 

Password failed for tape data set. 

220 

None 

IGC0N05B 

Address of data set label changed since 
checkpoint time. 

221 

None 

IGC0N05B 

Wrong password given for a password 
protected data set. 

222 

None 

IGC0S05B 

Tape data set name changed since 
checkpoint was taken. 

230 

None 

DSDRP 

Checkpoint data set not secure. 

231 

None 

DSDRP 

Error occurred during dynamic allocation 
of checkpoint data set. 

232 

None 

DSDRP 

Checkpoint data set could not be 
successfully opened. 

233 

None 

DSDRP 

Entry in directory for BPAM checkpoint 
data set not found. 

235 

None 

DSDRP 

A checkpoint entry record of 
undetermined type encountered in 
checkpoint data set. 

236 

None 

IGC0N05B 

A checkpoint entry record of 
undetermined type encountered in 
checkpoint data set. 

237 

None 

DSDRP 

Specified checkpoint entry not found. 

238 

None 

DSDRP 

SYSCHK DD did not specify explicit 

VOLUME and UNIT information. 

239 

None 

DSDRP 

Nondummy VIO data set found at deferred 
checkpoint restart time. 

240 

None 

IDA0A05B 

Recovery environment could not be 
established during VSAM restart. 

240 

None 

IDA0C05B 

Recovery environment could not be 
established during VSAM restart. 

241 

None 

IDA0A05B 

An indeterminate error occurred during 
VSAM restart. 

241 

None 

IDA0C05B 

An indeterminate error occurred during 
VSAM restart. 
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Message 

Number 

Reason 

Code 

Return 
Code 
(in hex) 

Module 

Detecting 

Error 

Meaning of Message code 


242 

None 

IDA0A05B 

A machine check occurred during VSAM 
restart. 


242 

None 

IDA0C05B 

A machine check occurred during VSAM 
restart. 


243 

None 

IDA0C05B 

An invalid SSCR record was encountered 
in the checkpoint data set during VSAM 
restart. 


251 

None 

IGC0Q05B 

A data set that was not a checkpoint 
data set at the time a checkpoint was 
taken was found to be open to a secure 
checkpoint data set at restart time. 


254 

None 

IGCON05B 

User not authorized to access 
RACF-protected data set. 


255 

None 

IGC0K05B 

User not authorized to access 
RACF-protected data set or tape volume. 

IHJ008I 

None 

None 

Not ap- 
plicable 

Restart at a checkpoint was successful. 

IHJ009I 

None 

None 

IDA0A05B 

VSAM detected an error while attempting 


to reposition a data set described by 
ddnarne. This message is followed by 
message IHJ007I. 
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ABBREVIATIONS 


ACB access method control block 

ANSI American National Standards 

Institute 

ASCB address space control block 

ASCII American National Standard 

Code for Information 
Interchange 

ASR allocated storage record 

ASRE allocated storage record 

element 

BDAM basic direct access method 

BPAM basic partitioned access 

method 

BSAM basic sequential access method 

CCI4 channel command word 

CDE contents directory element 

CHR checkpoint header record 

Cl compatibility interface 

CIR core image record 

CSA common service area 

CVT communications vector table 

DADSM direct access device space 

management 

DASD direct access storage device 

DCB data control block 

DDNT ddname table 

DEB data extent block 

DOS disk operating system 

DPQE dummy partition queue element 

DQE descriptor queue element 

DSAB data set association block 

DSCB data set control block 

DSDR data set descriptor record 

EBCDIC extended binary-coded-decimal 

interchange code 

ECB event control block 

EOB end of block 


EOF end of file 

EOV end of volume 

FBQE free block queue element 

FLIH first level interruption 

handler 

FOE fixed ownership element 

FQE free queue element 

GDG generation data group 

ICB interruption control block 

I/O input/output 

IOB input/output block 

IQE interruption queue element 

IRB interruption request block 

ISAM indexed sequential access 

method 

ISO International Organization for 

Standardization 

JCT job control table 

JFCB job file control block 

JSCB job step control block 

LLE load list element 

LPA link pack area 

LSQA local storage queue area 

MBBCCHHR absolute disk address 

MSS mass storage system 

NCP number of channel programs 

NSL nonstandard label 

O/C/EOV open/close/end of volume 

PCB page control block 

PIRL purge I/O restore list 

PO partitioned organization 

PQE partition queue element 

PRB program request block 

PS physical sequential 

QCB queue control block 
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QDB 

queue descriptor block 

STCB 

subtask control block 

QSAM 

queued sequential access 

SUR 

supervisor record 


method 

SVC 

supervisor call 

RACF 

Resource Access Control 

Faci1ity 

SVRB 

supervisor request block 

RB 

request block 

SWA 

scheduler work area 

R/TM 

recovery/termination manager 

TCAM 

telecommunications access 
method 

SAM 

sequential access method 

TCB 

task control block 

SCB 

STAE control block 

TIOT 

task input/output table 

SCT 

step control table 

TQE 

timer queue element 

SDWA 

STAE diagnostic work area 

TTR 

track* track* record (relative 

SIOT 

step input/output table 


track address) 

SIRB 

supervisor interruption 
request block 

UCB 

unit control block 



USASI 

USA Standards Institute 

SLIH 

second level interruption 
handler 

VAT 

valid AMBL table 

SPL 

service priority list 

VIO 

virtual input output 

SPQE 

subpool queue element 

VSAM 

virtual storage access method 

SSCR 

subsystem checkpoint record 

VTAM 

virtual telecommunications 
access method 

SSIB 

subsystem identification block 

VTOC 

volume table of contents 

SSOB 

subsystem option block 

WTO 

write to operator 

STAE 

specify task asynchronous exit 

XDAP 

execute direct access program 

STAI 

subtask ABEND interception 

XPTE 

external page table entry 

STC 

system task control 
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American National Standards Institute 
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automatic checkpoint restart 1 
automatic restart 1 
automatic step restart 1 


building checkpoint data set 
description 13, 15, 17 
diagram 12, 14, 16 
building data set entries 
description 31 
diagram 30 


m 

checkpoint 

method of operation diagrams 4-20 
overview of processing 1 
checkpoint data set 1 
checkpoint data set, building 
description 13, 15, 17 
diagram 12, 14, 16 
checkpoint exit 

description 21 
diagram 20 

checkpoint housekeeping and 
initialization 
description 7 
diagram 6 

checkpoint modules, diagram 47, 48 
checkpoint processing overview 
description 1 
diagram 4 

checkpoint/restart messages 75 
checkpoint/restart table of contents, 
diagram 3 
CHKPT macro 1 
control flow, module 46 


H 

deferred checkpoint restart 1 
deferred restart 1 
deferred step restart 1 
direct access data set processing 
description 39, 41, 43 
diagram 38, 40, 42 
dummy data set processing 
description 35 
diagram 34 
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EXEC statement, RD parameter 1 
exit, restart 

See restart exit 




I/O requests, user’s, restoring 
description 19 
diagram 18 


IDA0A05B 

43 


IDA0C05B 

39 


IDA0I96C 

17, 

19 

IGC0A06C 

13, 

54 

IGC0D06C 

13, 

54 

IGC0F06C 

54 


IGC0G05B 

54 


IGC0G06C 

15, 

54 

IGC0G95B 

54 


IGC0H05B 

35, 

54 

IGC0H06C 

15, 

54 

IGC0I05B 

54 


IGC0K05B 

37, 

54 

IGC0L05B 

37, 

54 

IGC0M05B 

39, 

54 

IGC0N05B 

39, 

54 

IGC0N06C 

17, 

19 

IGC0Q05B 

37, 

54 

IGC0Q06C 

54 


IGC0R05B 

41, 

54 

IGC0S05B 

37, 

54 

IGC0S06C 

54 


IGC0T05B 

43, 

54 

IGC0U05B 

37, 

54 

IGC0V05B 

54 


IGC0UI05B 

43, 

54 

IGC0005B 

25, 

54 

IGC0006C 

55 


IGC0106C 

55 


IGC0205B 

25, 

55 

IGC0206C 

55 


IGC0505B 

55 


IGC0506C 

11, 

55 

IGC0605B 

55 


IGC0705B 

55 


IGC0805B 

55 


IHJQCP30 

15 



International Organization for 
Standardization (ISO) 77 
ISO 77 

tn 

JOB statement, RD parameter 1 
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description 11 
diagram 10 


link pack area 1, 85 
locks 11 
LPA 1, 85 




messages issued by 
checkpoint/restart 75 
modules# major operations performed 
by 46 



nondirect access data set processing 
description 37 
diagram 36 



parameter 

RD in CHKPT macro 1 
RESTART in JOB statement 1 
processing direct access data sets 
description 39# 41# 43 
diagram 38# 40# 42 
processing dummy data sets 
description 35 
diagram 34 

processing nondirect access data sets 
description 37 
diagram 36 

purge I/O restore list (PIRL) 15 
purging user's I/O requests 


RD parameter 

in checkpoint macro 1 
restart exit 

description 45 

restart housekeeping and initialization 
description 25 
diagram 24 

restart modules# diagram 50# 51# 52# 53 
RESTART parameter in JOB statement 1 
restart processing overvieu 
description 1 
diagram 23 

restart# automatic and deferred 1 
restoring problem program and task 
control information to storage 
description 27 
diagram 26 

restoring user’s I/O requests 
description 19 
diagram 18 



statement 
EXEC 1 
JOB 1 

SYSCHK DD 1 
SVC 52 

description 46 
diagram 49# 50# 51# 
SVC 63 

description 46 
diagram 47# 48 
SYSCHK DD statement 1 
SYS1.LPALIB 1 


52, 53 
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